updated project site -- build no: 52 -- publish Ditto 1.1.2 release notes
diff --git a/1.0/2017-11-10-welcome-to-ditto.html b/1.0/2017-11-10-welcome-to-ditto.html
index ff1ca3d..efef57a 100644
--- a/1.0/2017-11-10-welcome-to-ditto.html
+++ b/1.0/2017-11-10-welcome-to-ditto.html
@@ -264,7 +264,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/2017-12-18-milestone-announcement-010-M1.html b/1.0/2017-12-18-milestone-announcement-010-M1.html
index 943da44..9f34025 100644
--- a/1.0/2017-12-18-milestone-announcement-010-M1.html
+++ b/1.0/2017-12-18-milestone-announcement-010-M1.html
@@ -268,7 +268,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/2018-01-12-milestone-announcement-010-M3.html b/1.0/2018-01-12-milestone-announcement-010-M3.html
index 9e78b79..a0bb673 100644
--- a/1.0/2018-01-12-milestone-announcement-010-M3.html
+++ b/1.0/2018-01-12-milestone-announcement-010-M3.html
@@ -287,7 +287,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/2018-01-15-example-demonstrating-rest-to-websocket.html b/1.0/2018-01-15-example-demonstrating-rest-to-websocket.html
index d9d565a..18dfb97 100644
--- a/1.0/2018-01-15-example-demonstrating-rest-to-websocket.html
+++ b/1.0/2018-01-15-example-demonstrating-rest-to-websocket.html
@@ -276,7 +276,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/2018-02-07-milestone-announcement-020-M1.html b/1.0/2018-02-07-milestone-announcement-020-M1.html
index cae16a5..1a484d5 100644
--- a/1.0/2018-02-07-milestone-announcement-020-M1.html
+++ b/1.0/2018-02-07-milestone-announcement-020-M1.html
@@ -288,7 +288,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/2018-02-08-feature-definition.html b/1.0/2018-02-08-feature-definition.html
index 75c9a85..fb8c0db 100644
--- a/1.0/2018-02-08-feature-definition.html
+++ b/1.0/2018-02-08-feature-definition.html
@@ -318,7 +318,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/2018-04-25-connectivity-service.html b/1.0/2018-04-25-connectivity-service.html
index 0838fc4..a65e841 100644
--- a/1.0/2018-04-25-connectivity-service.html
+++ b/1.0/2018-04-25-connectivity-service.html
@@ -332,7 +332,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/2018-04-26-milestone-announcement-030-M1.html b/1.0/2018-04-26-milestone-announcement-030-M1.html
index 4160311..b2bb7cc 100644
--- a/1.0/2018-04-26-milestone-announcement-030-M1.html
+++ b/1.0/2018-04-26-milestone-announcement-030-M1.html
@@ -284,7 +284,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/2018-05-02-connecting-ditto-hono.html b/1.0/2018-05-02-connecting-ditto-hono.html
index 06154c7..7f01943 100644
--- a/1.0/2018-05-02-connecting-ditto-hono.html
+++ b/1.0/2018-05-02-connecting-ditto-hono.html
@@ -257,7 +257,9 @@
- <p>With the recently released Ditto milestone <a href="2018-04-26-milestone-announcement-030-M1.html">0.3.0-M1</a> the <code class="highlighter-rouge">connectivity</code>
+ <div class="alert alert-danger" role="alert"><i class="fa fa-exclamation-circle"></i> <b>Warning:</b> This guide does no longer work with the latest (1.x) versions of Ditto + Hono. Please take a look and make use of the <a href="https://www.eclipse.org/packages/packages/cloud2edge/">Eclipse IoT Packages “cloud2edge” package</a> in order to setup and automatically connect Ditto + Hono.</div>
+
+<p>With the recently released Ditto milestone <a href="2018-04-26-milestone-announcement-030-M1.html">0.3.0-M1</a> the <code class="highlighter-rouge">connectivity</code>
to AMQP 1.0 endpoints can now be established in a durable and stable way (including failovers, etc.).</p>
<p>That means Ditto now is ready to be connected to <a href="https://www.eclipse.org/hono/">Eclipse Hono’s</a> “northbound” API which
@@ -450,7 +452,7 @@
}]
}
}
-}'</span> https://ditto.eclipse.org/devops/piggyback/connectivity?timeout<span class="o">=</span>8000
+}'</span> https://ditto.eclipse.org/devops/piggyback/connectivity?timeout<span class="o">=</span>8s
</code></pre></div></div>
<p>The result should be:</p>
@@ -592,7 +594,7 @@
}
}
}
-}'</span> https://ditto.eclipse.org/devops/piggyback/connectivity?timeout<span class="o">=</span>8000
+}'</span> https://ditto.eclipse.org/devops/piggyback/connectivity?timeout<span class="o">=</span>8s
</code></pre></div></div>
<p>When establishing the connection + parsing the JavaScript worked, we get a success result as HTTP response again,
@@ -612,7 +614,7 @@
"type": "connectivity.commands:retrieveConnectionMetrics",
"connectionId": "hono-sandbox-connection-1"
}
-}'</span> https://ditto.eclipse.org/devops/piggyback/connectivity?timeout<span class="o">=</span>8000
+}'</span> https://ditto.eclipse.org/devops/piggyback/connectivity?timeout<span class="o">=</span>8s
</code></pre></div></div>
<p>The result looks like this:</p>
@@ -1004,7 +1006,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/2018-06-15-milestone-announcement-030-M2.html b/1.0/2018-06-15-milestone-announcement-030-M2.html
index 5833615..0c1f143 100644
--- a/1.0/2018-06-15-milestone-announcement-030-M2.html
+++ b/1.0/2018-06-15-milestone-announcement-030-M2.html
@@ -284,7 +284,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/2018-08-14-milestone-announcement-080-M1.html b/1.0/2018-08-14-milestone-announcement-080-M1.html
index 31ff483..d8a69bd 100644
--- a/1.0/2018-08-14-milestone-announcement-080-M1.html
+++ b/1.0/2018-08-14-milestone-announcement-080-M1.html
@@ -284,7 +284,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/2018-09-21-selective-push-notifications.html b/1.0/2018-09-21-selective-push-notifications.html
index 6fdab3a..39536ca 100644
--- a/1.0/2018-09-21-selective-push-notifications.html
+++ b/1.0/2018-09-21-selective-push-notifications.html
@@ -484,7 +484,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/2018-09-27-milestone-announcement-080-M2.html b/1.0/2018-09-27-milestone-announcement-080-M2.html
index 3c4d887..e690c4b 100644
--- a/1.0/2018-09-27-milestone-announcement-080-M2.html
+++ b/1.0/2018-09-27-milestone-announcement-080-M2.html
@@ -286,7 +286,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/2018-10-16-example-mqtt-bidirectional.html b/1.0/2018-10-16-example-mqtt-bidirectional.html
index 5cf6186..694c483 100644
--- a/1.0/2018-10-16-example-mqtt-bidirectional.html
+++ b/1.0/2018-10-16-example-mqtt-bidirectional.html
@@ -292,7 +292,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/2018-11-14-milestone-announcement-080-M3.html b/1.0/2018-11-14-milestone-announcement-080-M3.html
index ac87a54..eb285ac 100644
--- a/1.0/2018-11-14-milestone-announcement-080-M3.html
+++ b/1.0/2018-11-14-milestone-announcement-080-M3.html
@@ -285,7 +285,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/2018-11-28-release-announcement-080.html b/1.0/2018-11-28-release-announcement-080.html
index 00c2942..fc5666a 100644
--- a/1.0/2018-11-28-release-announcement-080.html
+++ b/1.0/2018-11-28-release-announcement-080.html
@@ -280,7 +280,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/2018-12-05-example-command-and-control.html b/1.0/2018-12-05-example-command-and-control.html
index 12dcee8..0b78c63 100644
--- a/1.0/2018-12-05-example-command-and-control.html
+++ b/1.0/2018-12-05-example-command-and-control.html
@@ -379,7 +379,7 @@
}
}
}'</span> <span class="se">\</span>
- https://ditto.eclipse.org/devops/piggyback/connectivity?timeout<span class="o">=</span>10000
+ https://ditto.eclipse.org/devops/piggyback/connectivity?timeout<span class="o">=</span>10s
</code></pre></div></div>
<p>As described in the
@@ -519,7 +519,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/2019-03-13-kafka-connectivity.html b/1.0/2019-03-13-kafka-connectivity.html
index b4aafa6..b9c4a5b 100644
--- a/1.0/2019-03-13-kafka-connectivity.html
+++ b/1.0/2019-03-13-kafka-connectivity.html
@@ -266,7 +266,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/2019-03-28-milestone-announcement-090-M1.html b/1.0/2019-03-28-milestone-announcement-090-M1.html
index 23f3282..2e63693 100644
--- a/1.0/2019-03-28-milestone-announcement-090-M1.html
+++ b/1.0/2019-03-28-milestone-announcement-090-M1.html
@@ -282,7 +282,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/2019-04-29-milestone-announcement-090-M2.html b/1.0/2019-04-29-milestone-announcement-090-M2.html
index ea16b40..63c1251 100644
--- a/1.0/2019-04-29-milestone-announcement-090-M2.html
+++ b/1.0/2019-04-29-milestone-announcement-090-M2.html
@@ -280,7 +280,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/2019-07-10-release-announcement-090.html b/1.0/2019-07-10-release-announcement-090.html
index c7d6419..bc931fd 100644
--- a/1.0/2019-07-10-release-announcement-090.html
+++ b/1.0/2019-07-10-release-announcement-090.html
@@ -286,7 +286,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/2019-08-28-openid-connect.html b/1.0/2019-08-28-openid-connect.html
index 12f77f3..940c1ab 100644
--- a/1.0/2019-08-28-openid-connect.html
+++ b/1.0/2019-08-28-openid-connect.html
@@ -332,7 +332,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/2019-09-17-milestone-announcement-100-M1a.html b/1.0/2019-09-17-milestone-announcement-100-M1a.html
index a32e9a9..144f3fa 100644
--- a/1.0/2019-09-17-milestone-announcement-100-M1a.html
+++ b/1.0/2019-09-17-milestone-announcement-100-M1a.html
@@ -283,7 +283,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/2019-10-17-http-connectivity.html b/1.0/2019-10-17-http-connectivity.html
index b16a3b4..c39e1c9 100644
--- a/1.0/2019-10-17-http-connectivity.html
+++ b/1.0/2019-10-17-http-connectivity.html
@@ -261,7 +261,7 @@
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>{
"address": "POST:/trigger/<your-event-name>/with/key/<your-key>",
"topics": [
- "_/_/things/twin/events?filter=gt(features/temperature/value,25)"
+ "_/_/things/twin/events?filter=gt(features/temperature/properties/value,25)"
],
...
}
@@ -291,7 +291,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/2019-11-04-milestone-announcement-100-M2.html b/1.0/2019-11-04-milestone-announcement-100-M2.html
index 44ba91f..ea00975 100644
--- a/1.0/2019-11-04-milestone-announcement-100-M2.html
+++ b/1.0/2019-11-04-milestone-announcement-100-M2.html
@@ -282,7 +282,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/2019-12-12-release-announcement-100.html b/1.0/2019-12-12-release-announcement-100.html
index 359cee2..7ff13a3 100644
--- a/1.0/2019-12-12-release-announcement-100.html
+++ b/1.0/2019-12-12-release-announcement-100.html
@@ -331,7 +331,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/2020-04-16-connecting-to-ttn-via-mqtt.html b/1.0/2020-04-16-connecting-to-ttn-via-mqtt.html
new file mode 100644
index 0000000..d141522
--- /dev/null
+++ b/1.0/2020-04-16-connecting-to-ttn-via-mqtt.html
@@ -0,0 +1,817 @@
+<!DOCTYPE html>
+<html>
+<head>
+ <meta charset="utf-8">
+<meta http-equiv="X-UA-Compatible" content="IE=edge">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="description" content="">
+<meta name="keywords" content="blogconnectivity, ">
+<title> Digital twins of devices connected via LoRaWAN to TTN </title>
+
+<link rel="stylesheet" href="css/syntax.css">
+<link rel="stylesheet" type="text/css" href="//cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/modern-business.css">
+<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/customstyles.css">
+<link rel="stylesheet" href="css/boxshadowproperties.css">
+<link rel="stylesheet" href="css/theme-ditto.css">
+<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:400,700|Source+Code+Pro:300,600|Titillium+Web:400,600,700">
+
+<script src="//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.4/jquery.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/js/bootstrap.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/anchor-js/2.0.0/anchor.min.js" crossorigin="anonymous"></script>
+<script src="js/toc.js"></script>
+<script src="js/customscripts.js"></script>
+
+<script type="application/ld+json">
+{
+ "@context": "http://schema.org",
+ "@type": "Organization",
+ "url": "https://eclipse.org/ditto/",
+ "logo": "https://eclipse.org/ditto/images/ditto.svg"
+}
+</script>
+
+<link rel="icon" type="image/png" href="images/favicon-16x16.png" sizes="16x16">
+<link rel="icon" type="image/png" href="images/favicon-32x32.png" sizes="32x32">
+<link rel="icon" type="image/png" href="images/favicon-96x96.png" sizes="96x96">
+
+<link rel="alternate" type="application/rss+xml" title="Eclipse Ditto Blog" href="https://www.eclipse.org/ditto/feed.xml">
+
+<!-- Eclipse Foundation cookie consent: -->
+<link rel="stylesheet" type="text/css" href="//www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css" />
+<script src="//www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+ <script>
+ $(document).ready(function() {
+ $("#tg-sb-link").click(function() {
+ $("#tg-sb-sidebar").toggle();
+ $("#tg-sb-content").toggleClass('col-md-9');
+ $("#tg-sb-content").toggleClass('col-md-12');
+ $("#tg-sb-icon").toggleClass('fa-toggle-on');
+ $("#tg-sb-icon").toggleClass('fa-toggle-off');
+ });
+ });
+ </script>
+</head>
+
+
+<script>
+ (function(w,d,s,l,i){
+ w[l]=w[l]||[];
+ w[l].push({'gtm.start':
+ new Date().getTime(),event:'gtm.js'});
+ var f=d.getElementsByTagName(s)[0],
+ j=d.createElement(s),
+ dl=l!='dataLayer'?'&l='+l:'';
+ j.async=true;
+ j.src='https://www.googletagmanager.com/gtm.js?id='+i+dl;
+ f.parentNode.insertBefore(j,f);
+ })(window,document,'script','dataLayer','GTM-5WLCZXC');
+</script>
+
+
+
+<body>
+<!-- Navigation -->
+<nav class="navbar navbar-inverse navbar-fixed-top">
+ <div class="container topnavlinks">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-ditto-home" href="index.html"> <img src="images/ditto_allwhite_symbolonly.svg" class="ditto-navbar-symbol" alt="Home"> <img src="images/ditto_allwhite_textonly.svg" class="ditto-navbar-symbol-text" alt="Ditto"></a>
+ </div>
+ <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
+ <ul class="nav navbar-nav navbar-right">
+ <!-- toggle sidebar button -->
+ <!--<li><a id="tg-sb-link" href="#"><i id="tg-sb-icon" class="fa fa-toggle-on"></i> Nav</a></li>-->
+ <!-- entries without drop-downs appear here -->
+
+
+
+
+
+
+
+ <li><a href="blog.html">Blog</a></li>
+
+
+
+ <li><a href="intro-overview.html">Documentation</a></li>
+
+
+
+ <li><a href="http-api-doc.html">HTTP API</a></li>
+
+
+
+ <li><a href="https://ditto.eclipse.org" target="_blank">Sandbox</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">GitHub</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">GitHub examples</a></li>
+
+
+
+ <!-- entries with drop-downs appear here -->
+ <!-- conditional logic to control which topnav appears for the audience defined in the configuration file.-->
+
+
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Links<b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+
+ <li><a href="https://projects.eclipse.org/projects/iot.ditto" target="_blank">Eclipse Ditto Project</a></li>
+
+
+
+ <li><a href="https://www.eclipse.org/forums/index.php/f/364/" target="_blank">Forum</a></li>
+
+
+
+ <li><a href="https://ci.eclipse.org/ditto/" target="_blank">Jenkins</a></li>
+
+
+
+ <li><a href="https://dev.eclipse.org/mhonarc/lists/ditto-dev/" target="_blank">Mailing list archives</a></li>
+
+
+
+ <li><a href="https://gitter.im/eclipse/ditto" target="_blank">Gitter.im chat</a></li>
+
+
+ </ul>
+ </li>
+
+
+
+ <!--comment out this block if you want to hide search-->
+ <li>
+ <!--start search-->
+ <div id="search-demo-container">
+ <input type="text" id="search-input" placeholder="search...">
+ <ul id="results-container"></ul>
+ </div>
+ <script src="//cdnjs.cloudflare.com/ajax/libs/simple-jekyll-search/0.0.9/jekyll-search.js" type="text/javascript"></script>
+ <script type="text/javascript">
+ SimpleJekyllSearch.init({
+ searchInput: document.getElementById('search-input'),
+ resultsContainer: document.getElementById('results-container'),
+ dataSource: 'search.json',
+ searchResultTemplate: '<li><a href="{url}" title="Digital twins of devices connected via LoRaWAN to TTN">{title}</a></li>',
+ noResultsText: 'No results found.',
+ limit: 10,
+ fuzzy: true,
+ })
+ </script>
+ <!--end search-->
+ </li>
+ </ul>
+ </div>
+ </div>
+ <!-- /.container -->
+</nav>
+
+<!-- Page Content -->
+<div class="container">
+ <div id="main">
+ <!-- Content Row -->
+ <div class="row">
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-12" id="tg-sb-content">
+ <!-- Look the author details up from the site config. -->
+
+
+<!-- Output author details if some exist. -->
+<!-- Output author details if some exist. -->
+<!---->
+<!--<span>-->
+ <!--<!– Mugshot. –>-->
+ <!--<img src="https://www.gravatar.com/avatar/90a82dc2af1620df1f955e211ecc4dee?s=135" alt="A photo of Thomas Jäckle" />-->
+
+<!--<!– Personal Info. –>-->
+ <!--Written by <a href="http://twitter.com/thjaeckle" target="_blank">Thomas Jäckle</a>-->
+<!--</span>-->
+<!---->
+
+<article class="post" itemscope itemtype="http://schema.org/BlogPosting">
+
+ <header class="post-header">
+ <h1 class="post-title" itemprop="name headline">Digital twins of devices connected via LoRaWAN to TTN</h1>
+ <p class="post-meta">Published by <img src="https://www.gravatar.com/avatar/90a82dc2af1620df1f955e211ecc4dee?s=135" alt="A photo of Thomas Jäckle" style="width:50px;border-radius:50%;display:inline-block;margin-right:5px;" /><span itemprop="author" itemscope itemtype="http://schema.org/Person"><span itemprop="name"><a href="http://twitter.com/thjaeckle" target="_blank">Thomas Jäckle</a> </span></span> on <time datetime="2020-04-16T00:00:00+00:00" itemprop="datePublished">Apr 16, 2020</time> - Tags:
+
+
+
+ <a href="tag_blog.html">blog</a>,
+
+
+
+ <a href="tag_connectivity.html">connectivity</a>
+
+
+
+
+ </p>
+
+
+ </header>
+
+ <div class="post-content" itemprop="articleBody">
+
+
+
+
+
+<!-- this handles the automatic toc. use ## for subheads to auto-generate the on-page minitoc. if you use html tags, you must supply an ID for the heading element in order for it to appear in the minitoc. -->
+<script>
+$( document ).ready(function() {
+ // Handler for .ready() called.
+
+$('#toc').toc({ minimumHeaders: 0, listType: 'ul', showSpeed: 0, headers: 'h2,h3,h4' });
+
+/* this offset helps account for the space taken up by the floating toolbar. */
+$('#toc').on('click', 'a', function() {
+ var target = $(this.getAttribute('href'))
+ , scroll_target = target.offset().top
+
+ $(window).scrollTop(scroll_target - 10);
+ return false
+})
+
+});
+</script>
+
+<div id="toc"></div>
+
+
+
+ <figure><img class="docimage" src="images/2020-04-16-Logo_TTVC_color.png" alt="TTVC logo" style="max-width:300px;padding-left:1em;float:right" /></figure>
+
+<p><br /></p>
+
+<p>A workshop of the <a href="https://www.thethingsnetwork.org/article/the-things-virtual-conference">2020 The Things Virtual Conference</a>
+on April 16th 2020 is/was about how to connect Eclipse Ditto to “The Things Network” via TTN’s MQTT broker in order to
+automatically update digital twins of devices connected via LoRaWAN to the TTN backend.</p>
+
+<p>You can find the slides <a href="slides/2020_04_16-ttn-virtual-conference/index.html">here</a>.</p>
+
+<p>This blogpost helps setting up this kind of connection and shall also be used as a step-by-step tutorial during
+ the workshop.</p>
+
+<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/D33JrN2RWiI" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen=""></iframe>
+
+<h2 id="requirements">Requirements</h2>
+
+<p>You’ll need:</p>
+<ul>
+ <li>an operating system capable of running Docker (best use a Linux distribution)</li>
+ <li>4 CPU cores and 4GB of RAM are advised (less can work, but the Ditto cluster startup is more fragile then)</li>
+ <li>to have installed: <code class="highlighter-rouge">curl</code> and <code class="highlighter-rouge">git</code></li>
+</ul>
+
+<p>Also, you’ll need a TTN account and an existing application with at least one device if you want to follow the hands-on
+part and want to create digital twins of your devices connected to TTN.</p>
+
+<h2 id="preparation">Preparation</h2>
+
+<p>Please follow these initial preparation steps (if you don’t already have Docker and Docker Compose installed).</p>
+
+<p>When you have access to a Kubernetes cluster and already have worked with <a href="https://helm.sh">Helm</a> (the package manager
+for Kubernetes), you can alternatively install Ditto via its official
+<a href="https://hub.helm.sh/charts/eclipse-iot/ditto">Helm chart</a>.</p>
+
+<h3 id="install-docker">Install Docker</h3>
+
+<p>Assumption: You’re running a Debian or Ubuntu based Linux distribution containing the <code class="highlighter-rouge">apt</code> package manager.</p>
+
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">sudo </span>apt install docker.io
+<span class="nb">sudo </span>service docker start
+<span class="nb">sudo </span>usermod <span class="nt">-a</span> <span class="nt">-G</span> docker <your-username>
+</code></pre></div></div>
+
+<p>Logout and login again so that your user gets the “docker” group.</p>
+
+<h3 id="install-docker-compose">Install Docker Compose</h3>
+
+<p><a href="https://docs.docker.com/compose/install/">Follow the installation guide here</a>, in short:</p>
+
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">sudo </span>curl <span class="nt">-L</span> <span class="s2">"https://github.com/docker/compose/releases/download/1.25.4/docker-compose-</span><span class="k">$(</span>uname <span class="nt">-s</span><span class="k">)</span><span class="s2">-</span><span class="k">$(</span>uname <span class="nt">-m</span><span class="k">)</span><span class="s2">"</span> <span class="nt">-o</span> /usr/local/bin/docker-compose
+<span class="nb">sudo </span>chmod +x /usr/local/bin/docker-compose
+</code></pre></div></div>
+
+<h3 id="clone-ditto-codebase">Clone Ditto codebase</h3>
+
+<p>That is required to get the <code class="highlighter-rouge">docker-compose.yaml</code> file and other resources required to run Ditto with Docker Compose.</p>
+
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code>git clone <span class="nt">--depth</span> 1 https://github.com/eclipse/ditto.git
+</code></pre></div></div>
+
+<h2 id="startup-ditto-cluster">Startup Ditto cluster</h2>
+
+<p>Change directory into the just cloned git repository - optionally adjust the <code class="highlighter-rouge">DITTO_EXTERNAL_PORT</code> variable to where
+Ditto is reachable after the start:</p>
+
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">cd </span>ditto/deployment/docker/
+<span class="nb">export </span><span class="nv">DITTO_EXTERNAL_PORT</span><span class="o">=</span>80
+docker-compose up <span class="nt">-d</span>
+</code></pre></div></div>
+
+<p>Verify that Ditto is running:</p>
+
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code>docker-compose ps
+</code></pre></div></div>
+
+<p>The output should look similar like this:</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code> Name Command State Ports
+----------------------------------------------------------------------------------------
+docker_concierge_1 /sbin/tini -- java -jar st ... Up 8080/tcp
+docker_connectivity_1 /sbin/tini -- java -jar st ... Up 8080/tcp
+docker_gateway_1 /sbin/tini -- java -Dditto ... Up 0.0.0.0:8081->8080/tcp
+docker_mongodb_1 docker-entrypoint.sh mongo ... Up 27017/tcp
+docker_nginx_1 nginx -g daemon off; Up 0.0.0.0:80->80/tcp
+docker_policies_1 /sbin/tini -- java -jar st ... Up 8080/tcp
+docker_swagger-ui_1 nginx -g daemon off; Up 80/tcp, 8080/tcp
+docker_things-search_1 /sbin/tini -- java -jar st ... Up 8080/tcp
+docker_things_1 /sbin/tini -- java -jar st ... Up 8080/tcp
+</code></pre></div></div>
+
+<p>Verify that your Ditto cluster is healthy. Please give it ~1 minute in order to properly start up.</p>
+
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code>curl <span class="nt">-u</span> devops:foobar http://localhost:<span class="k">${</span><span class="nv">DITTO_EXTERNAL_PORT</span><span class="k">}</span>/status/health
+</code></pre></div></div>
+
+<p>The returned output should start with:</p>
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="s2">"label"</span><span class="p">:</span><span class="s2">"roles"</span><span class="p">,</span><span class="s2">"status"</span><span class="p">:</span><span class="s2">"UP"</span><span class="p">,</span><span class="w"> </span><span class="err">...</span><span class="w"> </span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<p>If your Ditto cluster has trouble starting up (e.g. because you only have less CPU cores than advised), try the following
+startup command instead:</p>
+
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code>docker-compose start mongodb<span class="p">;</span> sleep 30<span class="p">;</span> docker-compose start policies things<span class="p">;</span> sleep 60<span class="p">;</span> docker-compose start concierge<span class="p">;</span> sleep 60<span class="p">;</span> docker-compose start things-search<span class="p">;</span> sleep 60<span class="p">;</span> docker-compose start connectivity<span class="p">;</span> sleep 60<span class="p">;</span> docker-compose up <span class="nt">-d</span>
+</code></pre></div></div>
+
+<h2 id="configure-connection-to-ttn-mqtt-broker">Configure connection to TTN MQTT broker</h2>
+
+<p>The Things Network provides a built in MQTT broker which you can connect to using your TTN application credentials.
+For a more detailed description on that topic, please refer to the
+<a href="https://www.thethingsnetwork.org/docs/applications/mqtt/quick-start.html">TTN MQTT Quick Start</a>.</p>
+
+<p>Eclipse Ditto can establish connections to MQTT brokers. This is a schematic picture of what we now will do:</p>
+
+<figure><img class="docimage" src="images/../slides/images/ttn-ditto-via-mqtt.png" alt="TTN to Ditto via MQTT" style="max-width:600px;padding-left:1em" /></figure>
+
+<p>In order to connect to your own TTN application, perform the following steps.</p>
+
+<p>You can find the <code class="highlighter-rouge"><AppId></code> (application ID) and <code class="highlighter-rouge"><AppKey></code> (access key) in your TTN console of your application.
+For <code class="highlighter-rouge"><Region></code>, e.g. choose <code class="highlighter-rouge">'eu'</code> when your application is in handled by the Handler ‘ttn-handler-eu’.</p>
+
+<p>Please export your application’s credentials locally to environment variables:</p>
+
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">export </span><span class="nv">TTN_REGION</span><span class="o">=</span><span class="s1">'<Region>'</span>
+<span class="nb">export </span><span class="nv">TTN_APP_ID</span><span class="o">=</span><span class="s1">'<AppID>'</span>
+<span class="nb">export </span><span class="nv">TTN_APP_KEY</span><span class="o">=</span><span class="s1">'<AppKey>'</span>
+</code></pre></div></div>
+
+<p>After having done that, you can already create the connection of Ditto to the TTN MQTT broker:</p>
+
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code>curl <span class="nt">-X</span> POST <span class="nt">-u</span> devops:foobar <span class="nt">-H</span> <span class="s1">'Content-Type: application/json'</span> <span class="nt">-d</span> <span class="s1">'{
+ "targetActorSelection": "/system/sharding/connection",
+ "headers": {
+ "aggregate": false
+ },
+ "piggybackCommand": {
+ "type": "connectivity.commands:createConnection",
+ "connection": {
+ "id": "ttn-connection-via-mqtt",
+ "name": "TTN-MQTT",
+ "connectionType": "mqtt",
+ "connectionStatus": "open",
+ "uri": "tcp://'</span><span class="s2">"</span><span class="k">${</span><span class="nv">TTN_APP_ID</span><span class="k">}</span><span class="s2">"</span><span class="s1">':'</span><span class="s2">"</span><span class="k">${</span><span class="nv">TTN_APP_KEY</span><span class="k">}</span><span class="s2">"</span><span class="s1">'@'</span><span class="s2">"</span><span class="k">${</span><span class="nv">TTN_REGION</span><span class="k">}</span><span class="s2">"</span><span class="s1">'.thethings.network:1883",
+ "failoverEnabled": true,
+ "clientCount": 1,
+ "validateCertificates": false,
+ "sources": [{
+ "addresses": [
+ "'</span><span class="s2">"</span><span class="k">${</span><span class="nv">TTN_APP_ID</span><span class="k">}</span><span class="s2">"</span><span class="s1">'/devices/+/up"
+ ],
+ "consumerCount": 1,
+ "qos": 0,
+ "authorizationContext": [
+ "pre-authenticated:ttn-connection"
+ ],
+ "enforcement": {
+ "input": "{{ source:address }}",
+ "filters": [
+ "'</span><span class="s2">"</span><span class="k">${</span><span class="nv">TTN_APP_ID</span><span class="k">}</span><span class="s2">"</span><span class="s1">'/devices/{{ thing:name }}/up"
+ ]
+ },
+ "replyTarget": {
+ "enabled": false
+ },
+ "payloadMapping": [
+ "ttn-demo-mapping"
+ ]
+ }],
+ "mappingDefinitions": {
+ "ttn-demo-mapping": {
+ "mappingEngine": "JavaScript",
+ "options": {
+ "incomingScript": "function mapToDittoProtocolMsg(\n headers,\n textPayload,\n bytePayload,\n contentType\n) {\n\n let ttnJson = JSON.parse(textPayload);\n let deviceId = ttnJson['</span><span class="s2">"'"</span><span class="s1">'dev_id'</span><span class="s2">"'"</span><span class="s1">'];\n let payloadFields = ttnJson['</span><span class="s2">"'"</span><span class="s1">'payload_fields'</span><span class="s2">"'"</span><span class="s1">'];\n \n let attributesObj = {\n hardwareSerial: ttnJson['</span><span class="s2">"'"</span><span class="s1">'hardware_serial'</span><span class="s2">"'"</span><span class="s1">'],\n ttnCounter: ttnJson['</span><span class="s2">"'"</span><span class="s1">'counter'</span><span class="s2">"'"</span><span class="s1">']\n };\n \n let featuresObj = {\n temperature: {\n properties: {\n value: payloadFields['</span><span class="s2">"'"</span><span class="s1">'temperature_7'</span><span class="s2">"'"</span><span class="s1">']\n }\n },\n pressure: {\n properties: {\n value: payloadFields['</span><span class="s2">"'"</span><span class="s1">'barometric_pressure_10'</span><span class="s2">"'"</span><span class="s1">']\n }\n },\n humidity: {\n properties: {\n value: payloadFields['</span><span class="s2">"'"</span><span class="s1">'relative_humidity_8'</span><span class="s2">"'"</span><span class="s1">']\n }\n }\n };\n \n let thing = {\n attributes: attributesObj,\n features: featuresObj\n };\n \n let dittoHeaders = {\n '</span><span class="s2">"'"</span><span class="s1">'response-required'</span><span class="s2">"'"</span><span class="s1">': false,\n '</span><span class="s2">"'"</span><span class="s1">'If-Match'</span><span class="s2">"'"</span><span class="s1">': '</span><span class="s2">"'"</span><span class="s1">'*'</span><span class="s2">"'"</span><span class="s1">'\n };\n\n return Ditto.buildDittoProtocolMsg(\n '</span><span class="s2">"'"</span><span class="s1">'org.eclipse.ditto.ttn.demo'</span><span class="s2">"'"</span><span class="s1">',\n deviceId,\n '</span><span class="s2">"'"</span><span class="s1">'things'</span><span class="s2">"'"</span><span class="s1">',\n '</span><span class="s2">"'"</span><span class="s1">'twin'</span><span class="s2">"'"</span><span class="s1">',\n '</span><span class="s2">"'"</span><span class="s1">'commands'</span><span class="s2">"'"</span><span class="s1">',\n '</span><span class="s2">"'"</span><span class="s1">'modify'</span><span class="s2">"'"</span><span class="s1">',\n '</span><span class="s2">"'"</span><span class="s1">'/'</span><span class="s2">"'"</span><span class="s1">',\n dittoHeaders,\n thing\n );\n}",
+ "outgoingScript": "function mapFromDittoProtocolMsg() { return null; }",
+ "loadBytebufferJS": "false",
+ "loadLongJS": "false"
+ }
+ }
+ }
+ }
+ }
+}'</span> http://localhost:<span class="k">${</span><span class="nv">DITTO_EXTERNAL_PORT</span><span class="k">}</span>/devops/piggyback/connectivity?timeout<span class="o">=</span>8s
+</code></pre></div></div>
+
+<p>Explanation - what is done here:</p>
+<ul>
+ <li>using curl with the <code class="highlighter-rouge">devops</code> (admin) user and its initial password <code class="highlighter-rouge">foobar</code> we create a connection of type <code class="highlighter-rouge">mqtt</code>
+(you can find further information on that in Ditto’s <a href="connectivity-protocol-bindings-mqtt.html">MQTT docs</a>)</li>
+ <li>we use the TTN application credentials in the configured <code class="highlighter-rouge">"uri"</code>, connect via plain TCP
+(SSL is also possible but in this case a little more complicated as the server certificate of the TTN MQTT broker
+ would have to be imported)</li>
+ <li>we add an entry in <code class="highlighter-rouge">"sources"</code>:
+ <ul>
+ <li>defining the MQTT topic (<code class="highlighter-rouge">"addresses"</code>) to subscribe to</li>
+ <li>specifying in which <code class="highlighter-rouge">"authorizationContext"</code> messages from this connection shall be executed</li>
+ <li>defining in the <code class="highlighter-rouge">"enforcement"</code> that, based on the MQTT topic, a device may only update the Ditto twin having the same name</li>
+ <li>declaring that a custom payload mapping shall be applied for each incoming message</li>
+ </ul>
+ </li>
+ <li>in the <code class="highlighter-rouge">"mappingDefinitions"</code> we define the previously used “ttn-demo-mapping” as JavaScript based mapping:
+ <ul>
+ <li>only an “incoming” script is defined as we don’t handle downstream messages to TTN in this example</li>
+ <li>when you want to understand the script in more depth, please take a look at the <a href="#javascript-payload-mapping-script-in-detail">details about it</a></li>
+ </ul>
+ </li>
+</ul>
+
+<div class="alert alert-success" role="alert"><i class="fa fa-check-square-o"></i> <b>Tip:</b> As you have other custom <code class="highlighter-rouge">payload_fields</code> for your TTN devices, please adjust the script
+ if you want to see the device’s custom payload fields in your Ditto twins.</div>
+
+<h2 id="create-a-common-policy-for-the-twins-to-be-created">Create a common policy for the twins to be created</h2>
+
+<p>Eclipse Ditto secures each API access to the managed twins by applying authorization of the authenticated user.<br />
+Those “rules” which authenticated user may access which twins are defined in <a href="basic-policy.html">Policies</a>.</p>
+
+<p>In order to proceed with our scenario, we create a single Policy which shall be used for all twins we create in a later
+step:</p>
+
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code>curl <span class="nt">-X</span> PUT <span class="nt">-u</span> ditto:ditto <span class="nt">-H</span> <span class="s1">'Content-Type: application/json'</span> <span class="nt">-d</span> <span class="s1">'{
+ "policyId": "org.eclipse.ditto.ttn.demo:twin-policy",
+ "entries": {
+ "USER": {
+ "subjects": {
+ "nginx:ditto": {
+ "type": "basic auth user authenticated via nginx"
+ }
+ },
+ "resources": {
+ "thing:/": {
+ "grant": ["READ", "WRITE"],
+ "revoke": []
+ },
+ "policy:/": {
+ "grant": ["READ", "WRITE"],
+ "revoke": []
+ },
+ "message:/": {
+ "grant": ["READ", "WRITE"],
+ "revoke": []
+ }
+ }
+ },
+ "TTN": {
+ "subjects": {
+ "pre-authenticated:ttn-connection": {
+ "type": "used in the connections authorizationContext to the TTN MQTT"
+ }
+ },
+ "resources": {
+ "thing:/": {
+ "grant": ["WRITE"],
+ "revoke": []
+ }
+ }
+ }
+ }
+}'</span> http://localhost:<span class="k">${</span><span class="nv">DITTO_EXTERNAL_PORT</span><span class="k">}</span>/api/2/policies/org.eclipse.ditto.ttn.demo:twin-policy
+</code></pre></div></div>
+
+<p>Explanation - what is done here:</p>
+<ul>
+ <li>we create a new Policy with the ID <code class="highlighter-rouge">"org.eclipse.ditto.ttn.demo:twin-policy"</code></li>
+ <li>it contains 2 entries:
+ <ul>
+ <li><code class="highlighter-rouge">"USER"</code>: this Policy entry contains the authorization information of the user of the twin APIs (authenticated via the contained “nginx” acting as reverse proxy).
+ This user may READ+WRITE the things (twins), this created policy and may also send and receive messages.</li>
+ <li><code class="highlighter-rouge">"TTN"</code>: this Policy entry contains the authorization information of the connection to the TTN MQTT broker (the subject was configured as <code class="highlighter-rouge">"authorizationContext"</code> when we created the connection.
+ This connection may only WRITE (update) the things (twins).</li>
+ </ul>
+ </li>
+</ul>
+
+<h2 id="create-digital-twins">Create digital twins</h2>
+
+<p>Now we have everything in place in order to create digital twins for our devices connected to TTN.</p>
+
+<p>Please export all device ids you want to create digital twins for as comma separated environment variable:</p>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">export </span><span class="nv">TTN_DEVICE_IDS</span><span class="o">=</span><span class="s1">'<comma-separated-list-of-your-device-ids>'</span>
+</code></pre></div></div>
+
+<p>After having done that, we can already create the twins in Ditto as the <code class="highlighter-rouge">ditto</code> user:</p>
+
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="k">for </span>dev_id <span class="k">in</span> <span class="k">${</span><span class="nv">TTN_DEVICE_IDS</span><span class="p">//,/ </span><span class="k">}</span>
+<span class="k">do</span>
+ <span class="c"># call your procedure/other scripts here below</span>
+ <span class="nb">echo</span> <span class="s2">"Creating digital twin with Thing ID: org.eclipse.ditto.ttn.demo:</span><span class="nv">$dev_id</span><span class="s2">"</span>
+ curl <span class="nt">-X</span> PUT <span class="nt">-u</span> ditto:ditto <span class="nt">-H</span> <span class="s1">'Content-Type: application/json'</span> <span class="nt">-d</span> <span class="s1">'{
+ "policyId": "org.eclipse.ditto.ttn.demo:twin-policy"
+ }'</span> http://localhost:<span class="k">${</span><span class="nv">DITTO_EXTERNAL_PORT</span><span class="k">}</span>/api/2/things/org.eclipse.ditto.ttn.demo:<span class="nv">$dev_id</span>
+<span class="k">done</span>
+</code></pre></div></div>
+
+<p>Explanation - what is done here:</p>
+<ul>
+ <li>we split the passed in <code class="highlighter-rouge">TTN_DEVICE_IDS</code> environment variable by <code class="highlighter-rouge">,</code> and iterate over all contained device ids</li>
+ <li>for each device ID we create a new Thing (twin) referencing the already previously created Policy</li>
+</ul>
+
+<h2 id="access-your-digital-twins-via-api">Access your digital twins via API</h2>
+
+<p>Congratulations, if you have done it so far your TTN devices do now have digital twin representations in Eclipse Ditto.</p>
+
+<div class="alert alert-success" role="alert"><i class="fa fa-check-square-o"></i> <b>Tip:</b> Install the command line tool <code class="highlighter-rouge">jq</code> and pipe the output of the below <code class="highlighter-rouge">curl</code> commands to it in order to get
+ prettified and colored JSON</div>
+
+<div class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> Alternatively to <code class="highlighter-rouge">curl</code>, you may also use the locally deployed swagger-ui at http://localhost:${DITTO_EXTERNAL_PORT}/apidoc/
+ in order to try out Ditto’s HTTP API - <em>make sure to select</em> <code class="highlighter-rouge">/api/2 - local Ditto</code> in the ‘Servers’
+ section - when asked for credentials, use username ‘ditto’ and password ‘ditto’</div>
+
+<p>You can now, for example, use Ditto’s HTTP APIs in order</p>
+<ul>
+ <li>to retrieve the latest reported values: <code class="highlighter-rouge">curl -u ditto:ditto http://localhost:${DITTO_EXTERNAL_PORT}/api/2/things/org.eclipse.ditto.ttn.demo:<dev_id></code></li>
+ <li>to get a live stream of updates to the twins using SSE (Server Sent Events): <code class="highlighter-rouge">curl --http2 -u ditto:ditto -H 'Accept:text/event-stream' -N http://localhost:${DITTO_EXTERNAL_PORT}/api/2/things</code></li>
+ <li>to list all available twins via the search API: <code class="highlighter-rouge">curl -u ditto:ditto http://localhost:${DITTO_EXTERNAL_PORT}/api/2/search/things</code>
+ <ul>
+ <li>alternatively, use your browser and open http://localhost:${DITTO_EXTERNAL_PORT}/api/2/search/things</li>
+ <li>when asked for credentials, use username “ditto” and password “ditto”</li>
+ </ul>
+ </li>
+ <li>formulate a search query, e.g. only searching for twins with a temperature above 24°, sorted by the last modification, the most recent first
+to get the most active twin as first result:
+ <ul>
+ <li><code class="highlighter-rouge">curl -u ditto:ditto "http://localhost:${DITTO_EXTERNAL_PORT}/api/2/search/things?filter=gt(features/temperature/properties/value,24.0)&option=sort(-_modified),size(5)&fields=thingId,policyId,attributes,features,_modified,_revision"</code></li>
+ </ul>
+ </li>
+</ul>
+
+<h2 id="which-other-possibilities-do-we-now-have">Which other possibilities do we now have?</h2>
+
+<p>Now you have all the possibilities Eclipse Ditto as digital twin framework provides, e.g.:</p>
+<ul>
+ <li>directly use your device’s data in a web application consuming Ditto’s HTTP API</li>
+ <li>directly use your device’s data in a mobile app using Ditto’s bidirectional <a href="httpapi-protocol-bindings-websocket.html">WebSocket</a></li>
+ <li>make use of the <a href="https://github.com/eclpise/ditto-clients/">Eclipse Ditto Java or JavaScript clients</a> which also use the WebSocket to integrate your device’s data</li>
+ <li>create another connection (optionally also applying JavaScript based payload mapping)
+ <ul>
+ <li>to e.g. <a href="connectivity-protocol-bindings-kafka2.html">Apache Kafka</a> and forward all the modifications made to your devices to there</li>
+ <li>or using <a href="connectivity-protocol-bindings-http.html">HTTP push</a> in order to call another HTTP API (e.g. insert time series data into an InfluxDB via its HTTP API)</li>
+ </ul>
+ </li>
+</ul>
+
+<p><br />
+<br /></p>
+
+<p>For time reasons we do not go deeper into additional topics, they are possible however, please consult the Ditto
+documentation:</p>
+<ul>
+ <li>the WebSocket channel and subscribing for change notifications</li>
+ <li>sending downward messages to devices</li>
+ <li>live commands (not retrieving persisted data of devices, but live data)</li>
+ <li>a more detailed introduction into authentication mechanisms (<a href="installation-operating.html#openid-connect">OpenID Connect with OAuth2.0 is possible</a>)</li>
+ <li>possibilities to configure your Policies on every resource level, e.g. allowing individuals to only access certain values of a twin</li>
+ <li>and many other things..</li>
+</ul>
+
+<h2 id="additional-resources">Additional resources</h2>
+
+<h3 id="cleanup-after-the-workshop">Cleanup after the workshop</h3>
+
+<p>Simply perform in the <code class="highlighter-rouge">ditto/deployment/docker</code> folder:</p>
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code>docker-compose down
+</code></pre></div></div>
+
+<p>And unistall docker + docker-compose (for docker-compose, just remove the downloaded file) again, if you don’t need it.</p>
+
+<h3 id="javascript-payload-mapping-script-in-detail">JavaScript payload mapping script in detail</h3>
+
+<p>Similar to the TTN console’s decoding/converting capabilities of “Payload Formats” of an TTN application, Ditto is able
+to apply a custom JavaScript function for each consumed message.<br />
+That is necessary in order to convert the received data into a <a href="protocol-overview.html">Ditto Protocol</a> message
+including the JSON hierarchy of a so called <a href="basic-thing.html">Thing</a> being the representation of a digital twin.</p>
+
+<p>As the above injected JavaScript payload mapping script is formatted in a single line, this is the script we used pretty
+ formatted, including the jsdoc of the provided function and some other inline comments.</p>
+
+<p>If you need to adjust the script in order to use your own <code class="highlighter-rouge">payload_fields</code>, please replace all newlines with <code class="highlighter-rouge">\n</code> and
+escape the single quotes <code class="highlighter-rouge">'</code> in the script with the following replacement: <code class="highlighter-rouge">'"'"'</code>. Otherwise the single quotes won’t get
+correctly escaped in the bash. You can remove the comments before making a single line of the script.</p>
+
+<div class="language-javascript highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="cm">/**
+ * Maps the passed parameters to a Ditto Protocol message.
+ * @param {Object.<string, string>} headers - The headers Object containing all received header values
+ * @param {string} [textPayload] - The String to be mapped
+ * @param {ArrayBuffer} [bytePayload] - The bytes to be mapped as ArrayBuffer
+ * @param {string} [contentType] - The received Content-Type, e.g. "application/json"
+ * @returns {(DittoProtocolMessage|Array<DittoProtocolMessage>)} dittoProtocolMessage(s) -
+ * The mapped Ditto Protocol message,
+ * an array of Ditto Protocol messages or
+ * <code>null</code> if the message could/should not be mapped
+ */</span>
+<span class="kd">function</span> <span class="nx">mapToDittoProtocolMsg</span><span class="p">(</span>
+ <span class="nx">headers</span><span class="p">,</span>
+ <span class="nx">textPayload</span><span class="p">,</span>
+ <span class="nx">bytePayload</span><span class="p">,</span>
+ <span class="nx">contentType</span>
+<span class="p">)</span> <span class="p">{</span>
+
+ <span class="kd">let</span> <span class="nx">ttnJson</span> <span class="o">=</span> <span class="nx">JSON</span><span class="p">.</span><span class="nx">parse</span><span class="p">(</span><span class="nx">textPayload</span><span class="p">);</span> <span class="c1">// we simply parse the incoming TTN message as JSON</span>
+ <span class="kd">let</span> <span class="nx">deviceId</span> <span class="o">=</span> <span class="nx">ttnJson</span><span class="p">[</span><span class="s1">'dev_id'</span><span class="p">];</span> <span class="c1">// and extract some fields we require</span>
+ <span class="kd">let</span> <span class="nx">payloadFields</span> <span class="o">=</span> <span class="nx">ttnJson</span><span class="p">[</span><span class="s1">'payload_fields'</span><span class="p">];</span> <span class="c1">// the 'payload_fields' content is - obviously - different for your application</span>
+
+ <span class="kd">let</span> <span class="nx">attributesObj</span> <span class="o">=</span> <span class="p">{</span> <span class="c1">// the attributes of a Thing are meant for unstructured data </span>
+ <span class="na">hardwareSerial</span><span class="p">:</span> <span class="nx">ttnJson</span><span class="p">[</span><span class="s1">'hardware_serial'</span><span class="p">],</span>
+ <span class="na">ttnCounter</span><span class="p">:</span> <span class="nx">ttnJson</span><span class="p">[</span><span class="s1">'counter'</span><span class="p">]</span>
+ <span class="p">};</span>
+
+ <span class="kd">let</span> <span class="nx">featuresObj</span> <span class="o">=</span> <span class="p">{</span> <span class="c1">// the features of a Thing e.g. contain sensor data of devices</span>
+ <span class="na">temperature</span><span class="p">:</span> <span class="p">{</span>
+ <span class="na">properties</span><span class="p">:</span> <span class="p">{</span>
+ <span class="na">value</span><span class="p">:</span> <span class="nx">payloadFields</span><span class="p">[</span><span class="s1">'temperature_7'</span><span class="p">]</span>
+ <span class="p">}</span>
+ <span class="p">},</span>
+ <span class="na">pressure</span><span class="p">:</span> <span class="p">{</span>
+ <span class="na">properties</span><span class="p">:</span> <span class="p">{</span>
+ <span class="na">value</span><span class="p">:</span> <span class="nx">payloadFields</span><span class="p">[</span><span class="s1">'barometric_pressure_10'</span><span class="p">]</span>
+ <span class="p">}</span>
+ <span class="p">},</span>
+ <span class="na">humidity</span><span class="p">:</span> <span class="p">{</span>
+ <span class="na">properties</span><span class="p">:</span> <span class="p">{</span>
+ <span class="na">value</span><span class="p">:</span> <span class="nx">payloadFields</span><span class="p">[</span><span class="s1">'relative_humidity_8'</span><span class="p">]</span>
+ <span class="p">}</span>
+ <span class="p">}</span>
+ <span class="p">};</span>
+
+ <span class="kd">let</span> <span class="nx">thing</span> <span class="o">=</span> <span class="p">{</span> <span class="c1">// a Thing can contain both attributes and features</span>
+ <span class="na">attributes</span><span class="p">:</span> <span class="nx">attributesObj</span><span class="p">,</span>
+ <span class="na">features</span><span class="p">:</span> <span class="nx">featuresObj</span>
+ <span class="p">};</span>
+
+ <span class="kd">let</span> <span class="nx">dittoHeaders</span> <span class="o">=</span> <span class="p">{</span>
+ <span class="s1">'response-required'</span><span class="p">:</span> <span class="kc">false</span><span class="p">,</span> <span class="c1">// we don't expect a response sent back to TTN</span>
+ <span class="s1">'If-Match'</span><span class="p">:</span> <span class="s1">'*'</span> <span class="c1">// we only want to update the thing if it already exists</span>
+ <span class="p">};</span>
+
+ <span class="k">return</span> <span class="nx">Ditto</span><span class="p">.</span><span class="nx">buildDittoProtocolMsg</span><span class="p">(</span>
+ <span class="s1">'org.eclipse.ditto.ttn.demo'</span><span class="p">,</span> <span class="c1">// this is the namespace used as prefix for Ditto Thing IDs</span>
+ <span class="nx">deviceId</span><span class="p">,</span> <span class="c1">// the TTN device ID is used as "name" part of the Ditto Thing ID </span>
+ <span class="s1">'things'</span><span class="p">,</span>
+ <span class="s1">'twin'</span><span class="p">,</span>
+ <span class="s1">'commands'</span><span class="p">,</span>
+ <span class="s1">'modify'</span><span class="p">,</span>
+ <span class="s1">'/'</span><span class="p">,</span>
+ <span class="nx">dittoHeaders</span><span class="p">,</span>
+ <span class="nx">thing</span>
+ <span class="p">);</span>
+<span class="p">}</span>
+</code></pre></div></div>
+
+<p>An example message received from the TTN MQTT broker:</p>
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"app_id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"iot-campus-be12"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"dev_id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"node0"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"hardware_serial"</span><span class="p">:</span><span class="w"> </span><span class="s2">"70B3D5499A2D3954"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"port"</span><span class="p">:</span><span class="w"> </span><span class="mi">2</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"counter"</span><span class="p">:</span><span class="w"> </span><span class="mi">9449</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"payload_raw"</span><span class="p">:</span><span class="w"> </span><span class="s2">"B2cA6AhoKwpzJ8oEAwH4"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"payload_fields"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"analog_out_4"</span><span class="p">:</span><span class="w"> </span><span class="mf">5.04</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"barometric_pressure_10"</span><span class="p">:</span><span class="w"> </span><span class="mf">1018.6</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"relative_humidity_8"</span><span class="p">:</span><span class="w"> </span><span class="mf">21.5</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"temperature_7"</span><span class="p">:</span><span class="w"> </span><span class="mf">23.2</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"metadata"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="err">...</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<p>would be transformed to the following Ditto Protocol message:</p>
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/node0/things/twin/commands/modify"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"attributes"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"hardwareSerial"</span><span class="p">:</span><span class="w"> </span><span class="s2">"70B3D5499A2D3954"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"ttnCounter"</span><span class="p">:</span><span class="w"> </span><span class="mi">9449</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"features"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"temperature"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"properties"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="mf">23.2</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"pressure"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"properties"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="mf">1018.6</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"humidity"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"properties"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="mf">21.5</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<p><br />
+<br /></p>
+<figure><img class="docimage" src="images/ditto.svg" alt="Ditto" style="max-width: 500px" /></figure>
+
+<p>–<br />
+The Eclipse Ditto team</p>
+
+ </div>
+
+
+
+</article>
+
+<hr class="shaded"/>
+
+<footer>
+ <div class="row">
+ <div class="col-lg-12 footer">
+ <div class="logo">
+ <a href="https://eclipse.org"><img src="images/eclipse_foundation_logo.svg" alt="Eclipse logo"/></a>
+ </div>
+ <p class="notice">
+ ©2020 Eclipse Ditto.
+ Site last generated: Jul 1, 2020 <br />
+ </p>
+ <div class="quickLinks">
+ <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
+ > Privacy Policy
+ </a>
+ <a href="https://www.eclipse.org/legal/termsofuse.php" target="_blank">
+ > Terms of Use
+ </a>
+ <a href="https://www.eclipse.org/legal/copyright.php" target="_blank">
+ > Copyright Agent
+ </a>
+ <a href="https://www.eclipse.org/legal" target="_blank">
+ > Legal
+ </a>
+ <a href="https://www.eclipse.org/legal/epl-2.0/" target="_blank">
+ > License
+ </a>
+ <a href="https://eclipse.org/security" target="_blank">
+ > Report a Vulnerability
+ </a>
+ </div>
+ </div>
+ </div>
+</footer>
+
+
+ </div>
+ <!-- /.row -->
+</div>
+<!-- /.container -->
+</div>
+<!-- /#main -->
+ </div>
+
+</body>
+</html>
diff --git a/1.0/2020-04-29-release-announcement-110.html b/1.0/2020-04-29-release-announcement-110.html
new file mode 100644
index 0000000..9529814
--- /dev/null
+++ b/1.0/2020-04-29-release-announcement-110.html
@@ -0,0 +1,351 @@
+<!DOCTYPE html>
+<html>
+<head>
+ <meta charset="utf-8">
+<meta http-equiv="X-UA-Compatible" content="IE=edge">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="description" content="">
+<meta name="keywords" content="blog, ">
+<title> Announcing Eclipse Ditto Release 1.1.0 </title>
+
+<link rel="stylesheet" href="css/syntax.css">
+<link rel="stylesheet" type="text/css" href="//cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/modern-business.css">
+<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/customstyles.css">
+<link rel="stylesheet" href="css/boxshadowproperties.css">
+<link rel="stylesheet" href="css/theme-ditto.css">
+<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:400,700|Source+Code+Pro:300,600|Titillium+Web:400,600,700">
+
+<script src="//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.4/jquery.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/js/bootstrap.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/anchor-js/2.0.0/anchor.min.js" crossorigin="anonymous"></script>
+<script src="js/toc.js"></script>
+<script src="js/customscripts.js"></script>
+
+<script type="application/ld+json">
+{
+ "@context": "http://schema.org",
+ "@type": "Organization",
+ "url": "https://eclipse.org/ditto/",
+ "logo": "https://eclipse.org/ditto/images/ditto.svg"
+}
+</script>
+
+<link rel="icon" type="image/png" href="images/favicon-16x16.png" sizes="16x16">
+<link rel="icon" type="image/png" href="images/favicon-32x32.png" sizes="32x32">
+<link rel="icon" type="image/png" href="images/favicon-96x96.png" sizes="96x96">
+
+<link rel="alternate" type="application/rss+xml" title="Eclipse Ditto Blog" href="https://www.eclipse.org/ditto/feed.xml">
+
+<!-- Eclipse Foundation cookie consent: -->
+<link rel="stylesheet" type="text/css" href="//www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css" />
+<script src="//www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+ <script>
+ $(document).ready(function() {
+ $("#tg-sb-link").click(function() {
+ $("#tg-sb-sidebar").toggle();
+ $("#tg-sb-content").toggleClass('col-md-9');
+ $("#tg-sb-content").toggleClass('col-md-12');
+ $("#tg-sb-icon").toggleClass('fa-toggle-on');
+ $("#tg-sb-icon").toggleClass('fa-toggle-off');
+ });
+ });
+ </script>
+</head>
+
+
+<script>
+ (function(w,d,s,l,i){
+ w[l]=w[l]||[];
+ w[l].push({'gtm.start':
+ new Date().getTime(),event:'gtm.js'});
+ var f=d.getElementsByTagName(s)[0],
+ j=d.createElement(s),
+ dl=l!='dataLayer'?'&l='+l:'';
+ j.async=true;
+ j.src='https://www.googletagmanager.com/gtm.js?id='+i+dl;
+ f.parentNode.insertBefore(j,f);
+ })(window,document,'script','dataLayer','GTM-5WLCZXC');
+</script>
+
+
+
+<body>
+<!-- Navigation -->
+<nav class="navbar navbar-inverse navbar-fixed-top">
+ <div class="container topnavlinks">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-ditto-home" href="index.html"> <img src="images/ditto_allwhite_symbolonly.svg" class="ditto-navbar-symbol" alt="Home"> <img src="images/ditto_allwhite_textonly.svg" class="ditto-navbar-symbol-text" alt="Ditto"></a>
+ </div>
+ <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
+ <ul class="nav navbar-nav navbar-right">
+ <!-- toggle sidebar button -->
+ <!--<li><a id="tg-sb-link" href="#"><i id="tg-sb-icon" class="fa fa-toggle-on"></i> Nav</a></li>-->
+ <!-- entries without drop-downs appear here -->
+
+
+
+
+
+
+
+ <li><a href="blog.html">Blog</a></li>
+
+
+
+ <li><a href="intro-overview.html">Documentation</a></li>
+
+
+
+ <li><a href="http-api-doc.html">HTTP API</a></li>
+
+
+
+ <li><a href="https://ditto.eclipse.org" target="_blank">Sandbox</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">GitHub</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">GitHub examples</a></li>
+
+
+
+ <!-- entries with drop-downs appear here -->
+ <!-- conditional logic to control which topnav appears for the audience defined in the configuration file.-->
+
+
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Links<b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+
+ <li><a href="https://projects.eclipse.org/projects/iot.ditto" target="_blank">Eclipse Ditto Project</a></li>
+
+
+
+ <li><a href="https://www.eclipse.org/forums/index.php/f/364/" target="_blank">Forum</a></li>
+
+
+
+ <li><a href="https://ci.eclipse.org/ditto/" target="_blank">Jenkins</a></li>
+
+
+
+ <li><a href="https://dev.eclipse.org/mhonarc/lists/ditto-dev/" target="_blank">Mailing list archives</a></li>
+
+
+
+ <li><a href="https://gitter.im/eclipse/ditto" target="_blank">Gitter.im chat</a></li>
+
+
+ </ul>
+ </li>
+
+
+
+ <!--comment out this block if you want to hide search-->
+ <li>
+ <!--start search-->
+ <div id="search-demo-container">
+ <input type="text" id="search-input" placeholder="search...">
+ <ul id="results-container"></ul>
+ </div>
+ <script src="//cdnjs.cloudflare.com/ajax/libs/simple-jekyll-search/0.0.9/jekyll-search.js" type="text/javascript"></script>
+ <script type="text/javascript">
+ SimpleJekyllSearch.init({
+ searchInput: document.getElementById('search-input'),
+ resultsContainer: document.getElementById('results-container'),
+ dataSource: 'search.json',
+ searchResultTemplate: '<li><a href="{url}" title="Announcing Eclipse Ditto Release 1.1.0">{title}</a></li>',
+ noResultsText: 'No results found.',
+ limit: 10,
+ fuzzy: true,
+ })
+ </script>
+ <!--end search-->
+ </li>
+ </ul>
+ </div>
+ </div>
+ <!-- /.container -->
+</nav>
+
+<!-- Page Content -->
+<div class="container">
+ <div id="main">
+ <!-- Content Row -->
+ <div class="row">
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-12" id="tg-sb-content">
+ <!-- Look the author details up from the site config. -->
+
+
+<!-- Output author details if some exist. -->
+<!-- Output author details if some exist. -->
+<!---->
+<!--<span>-->
+ <!--<!– Mugshot. –>-->
+ <!--<img src="https://www.gravatar.com/avatar/90a82dc2af1620df1f955e211ecc4dee?s=135" alt="A photo of Thomas Jäckle" />-->
+
+<!--<!– Personal Info. –>-->
+ <!--Written by <a href="http://twitter.com/thjaeckle" target="_blank">Thomas Jäckle</a>-->
+<!--</span>-->
+<!---->
+
+<article class="post" itemscope itemtype="http://schema.org/BlogPosting">
+
+ <header class="post-header">
+ <h1 class="post-title" itemprop="name headline">Announcing Eclipse Ditto Release 1.1.0</h1>
+ <p class="post-meta">Published by <img src="https://www.gravatar.com/avatar/90a82dc2af1620df1f955e211ecc4dee?s=135" alt="A photo of Thomas Jäckle" style="width:50px;border-radius:50%;display:inline-block;margin-right:5px;" /><span itemprop="author" itemscope itemtype="http://schema.org/Person"><span itemprop="name"><a href="http://twitter.com/thjaeckle" target="_blank">Thomas Jäckle</a> </span></span> on <time datetime="2020-04-29T00:00:00+00:00" itemprop="datePublished">Apr 29, 2020</time> - Tags:
+
+
+
+ <a href="tag_blog.html">blog</a>
+
+
+
+
+ </p>
+
+
+ </header>
+
+ <div class="post-content" itemprop="articleBody">
+
+
+
+
+
+ <p>Today, approximately 4 months after Eclipse Ditto’s <a href="2019-12-12-release-announcement-100.html">1.0.0</a> release,
+the team is happy to announce the first minor (feature) update of Ditto <code class="highlighter-rouge">1.0</code>:<br />
+<strong>Eclipse Ditto 1.1.0</strong></p>
+
+<p>The Ditto team was quite busy, 1.1.0 focuses on the following areas:</p>
+
+<ul>
+ <li>Management of <a href="basic-policy.html">Policies</a> via <a href="protocol-specification-policies.html">Ditto Protocol</a>
+ <ul>
+ <li>Addition of policy APIs in Ditto <a href="client-sdk-java.html">Java client</a></li>
+ </ul>
+ </li>
+ <li>Possibility to <a href="basic-search.html">search</a> via <a href="protocol-specification-things-search.html">Ditto Protocol</a>
+ <ul>
+ <li>Addition of search APIs in Ditto <a href="client-sdk-java.html">Java client</a></li>
+ </ul>
+ </li>
+ <li>Enrich published Ditto events/message via additional <a href="basic-enrichment.html">custom fields</a> of the affected thing
+ <ul>
+ <li>Addition of enrichment APIs in Ditto <a href="client-sdk-java.html">Java client</a></li>
+ </ul>
+ </li>
+ <li>Support for establishing managed <a href="basic-connections.html">connections</a> via <a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5</a></li>
+ <li>End-2-end <a href="basic-acknowledgements.html">acknowledgements</a> preparing Ditto to enable “at least once” processing
+ <ul>
+ <li>Addition of acknowledgement APIs in Ditto <a href="client-sdk-java.html">Java client</a></li>
+ </ul>
+ </li>
+ <li>Officially documented <a href="installation-operating.html#pre-authentication">pre-authenticated</a> authentication mechanism</li>
+ <li>Use of Java 11 for running Ditto containers</li>
+ <li>Deprecation of API version 1 (authorization via <a href="basic-acl.html">ACL</a> mechanism)</li>
+ <li>Use of CBOR as cluster internal replacement for JSON serialization</li>
+ <li>Further improvements on increasing throughput</li>
+</ul>
+
+<p>Please have a look at the <a href="release_notes_110.html">1.1.0 release notes</a> for a more detailed information on the release.</p>
+
+<h2 id="artifacts">Artifacts</h2>
+
+<p>The new Java artifacts have been published at the <a href="https://repo.eclipse.org/content/repositories/ditto/">Eclipse Maven repository</a>
+as well as <a href="https://repo1.maven.org/maven2/org/eclipse/ditto/">Maven central</a>.</p>
+
+<p>Also the <a href="client-sdk-java.html">Ditto Java client</a>’s artifacts were published to Maven central.</p>
+
+<p>The Docker images have been pushed to Docker Hub:</p>
+<ul>
+ <li><a href="https://hub.docker.com/r/eclipse/ditto-policies/">eclipse/ditto-policies</a></li>
+ <li><a href="https://hub.docker.com/r/eclipse/ditto-things/">eclipse/ditto-things</a></li>
+ <li><a href="https://hub.docker.com/r/eclipse/ditto-things-search/">eclipse/ditto-things-search</a></li>
+ <li><a href="https://hub.docker.com/r/eclipse/ditto-gateway/">eclipse/ditto-gateway</a></li>
+ <li><a href="https://hub.docker.com/r/eclipse/ditto-connectivity/">eclipse/ditto-connectivity</a></li>
+ <li><a href="https://hub.docker.com/r/eclipse/ditto-concierge/">eclipse/ditto-concierge</a></li>
+</ul>
+
+<h2 id="kubernetes-ready-helm-chart">Kubernetes ready: Helm chart</h2>
+
+<p>In order to run Eclipse Ditto in a Kubernetes environment, best rely on the official
+<a href="https://hub.helm.sh/charts/eclipse-iot/ditto">Helm chart</a> and deploy Ditto via the Helm package manager.</p>
+
+<p><br />
+<br /></p>
+<figure><img class="docimage" src="images/ditto.svg" alt="Ditto" style="max-width: 500px" /></figure>
+
+<p>–<br />
+The Eclipse Ditto team</p>
+
+ </div>
+
+
+
+</article>
+
+<hr class="shaded"/>
+
+<footer>
+ <div class="row">
+ <div class="col-lg-12 footer">
+ <div class="logo">
+ <a href="https://eclipse.org"><img src="images/eclipse_foundation_logo.svg" alt="Eclipse logo"/></a>
+ </div>
+ <p class="notice">
+ ©2020 Eclipse Ditto.
+ Site last generated: Jul 1, 2020 <br />
+ </p>
+ <div class="quickLinks">
+ <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
+ > Privacy Policy
+ </a>
+ <a href="https://www.eclipse.org/legal/termsofuse.php" target="_blank">
+ > Terms of Use
+ </a>
+ <a href="https://www.eclipse.org/legal/copyright.php" target="_blank">
+ > Copyright Agent
+ </a>
+ <a href="https://www.eclipse.org/legal" target="_blank">
+ > Legal
+ </a>
+ <a href="https://www.eclipse.org/legal/epl-2.0/" target="_blank">
+ > License
+ </a>
+ <a href="https://eclipse.org/security" target="_blank">
+ > Report a Vulnerability
+ </a>
+ </div>
+ </div>
+ </div>
+</footer>
+
+
+ </div>
+ <!-- /.row -->
+</div>
+<!-- /.container -->
+</div>
+<!-- /#main -->
+ </div>
+
+</body>
+</html>
diff --git a/1.0/404.html b/1.0/404.html
index e93895c..75f96bd 100644
--- a/1.0/404.html
+++ b/1.0/404.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1269,7 +1490,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/architecture-overview.html b/1.0/architecture-overview.html
index 1ae8b44..9621ae5 100644
--- a/1.0/architecture-overview.html
+++ b/1.0/architecture-overview.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1322,7 +1543,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/architecture-services-concierge.html b/1.0/architecture-services-concierge.html
index 6393ab0..b8abd57 100644
--- a/1.0/architecture-services-concierge.html
+++ b/1.0/architecture-services-concierge.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1308,7 +1529,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/architecture-services-connectivity.html b/1.0/architecture-services-connectivity.html
index 2016c10..628418d 100644
--- a/1.0/architecture-services-connectivity.html
+++ b/1.0/architecture-services-connectivity.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1322,7 +1543,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/architecture-services-gateway.html b/1.0/architecture-services-gateway.html
index bc243f1..d9bcf23 100644
--- a/1.0/architecture-services-gateway.html
+++ b/1.0/architecture-services-gateway.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1300,7 +1521,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/architecture-services-policies.html b/1.0/architecture-services-policies.html
index 89cf94e..41b7876 100644
--- a/1.0/architecture-services-policies.html
+++ b/1.0/architecture-services-policies.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1301,7 +1522,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/architecture-services-things-search.html b/1.0/architecture-services-things-search.html
index 5a06459..1bc1e4f 100644
--- a/1.0/architecture-services-things-search.html
+++ b/1.0/architecture-services-things-search.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1345,7 +1566,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/architecture-services-things.html b/1.0/architecture-services-things.html
index db2eb3a..504dd72 100644
--- a/1.0/architecture-services-things.html
+++ b/1.0/architecture-services-things.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1301,7 +1522,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/basic-acknowledgements.html b/1.0/basic-acknowledgements.html
new file mode 100644
index 0000000..13476a8
--- /dev/null
+++ b/1.0/basic-acknowledgements.html
@@ -0,0 +1,1710 @@
+<!DOCTYPE html>
+<html>
+<head>
+ <meta charset="utf-8">
+<meta http-equiv="X-UA-Compatible" content="IE=edge">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="description" content="">
+<meta name="keywords" content="model, acks, acknowledgement, acknowledgements, qos, at least once">
+<title> Acknowledgements • Eclipse Ditto • a digital twin framework</title>
+
+<link rel="stylesheet" href="css/syntax.css">
+<link rel="stylesheet" type="text/css" href="//cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/modern-business.css">
+<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/customstyles.css">
+<link rel="stylesheet" href="css/boxshadowproperties.css">
+<link rel="stylesheet" href="css/theme-ditto.css">
+<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:400,700|Source+Code+Pro:300,600|Titillium+Web:400,600,700">
+
+<script src="//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.4/jquery.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/js/bootstrap.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/anchor-js/2.0.0/anchor.min.js" crossorigin="anonymous"></script>
+<script src="js/toc.js"></script>
+<script src="js/customscripts.js"></script>
+
+<script type="application/ld+json">
+{
+ "@context": "http://schema.org",
+ "@type": "Organization",
+ "url": "https://eclipse.org/ditto/",
+ "logo": "https://eclipse.org/ditto/images/ditto.svg"
+}
+</script>
+
+<link rel="icon" type="image/png" href="images/favicon-16x16.png" sizes="16x16">
+<link rel="icon" type="image/png" href="images/favicon-32x32.png" sizes="32x32">
+<link rel="icon" type="image/png" href="images/favicon-96x96.png" sizes="96x96">
+
+<link rel="alternate" type="application/rss+xml" title="Eclipse Ditto Blog" href="https://www.eclipse.org/ditto/feed.xml">
+
+<!-- Eclipse Foundation cookie consent: -->
+<link rel="stylesheet" type="text/css" href="//www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css" />
+<script src="//www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+ <script>
+ $(document).ready(function() {
+ $("#tg-sb-link").click(function() {
+ $("#tg-sb-sidebar").toggle();
+ $("#tg-sb-content").toggleClass('col-md-9');
+ $("#tg-sb-content").toggleClass('col-md-12');
+ $("#tg-sb-icon").toggleClass('fa-toggle-on');
+ $("#tg-sb-icon").toggleClass('fa-toggle-off');
+ });
+ });
+ </script>
+</head>
+
+
+<script>
+ (function(w,d,s,l,i){
+ w[l]=w[l]||[];
+ w[l].push({'gtm.start':
+ new Date().getTime(),event:'gtm.js'});
+ var f=d.getElementsByTagName(s)[0],
+ j=d.createElement(s),
+ dl=l!='dataLayer'?'&l='+l:'';
+ j.async=true;
+ j.src='https://www.googletagmanager.com/gtm.js?id='+i+dl;
+ f.parentNode.insertBefore(j,f);
+ })(window,document,'script','dataLayer','GTM-5WLCZXC');
+</script>
+
+
+
+<body>
+<!-- Navigation -->
+<nav class="navbar navbar-inverse navbar-fixed-top">
+ <div class="container topnavlinks">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-ditto-home" href="index.html"> <img src="images/ditto_allwhite_symbolonly.svg" class="ditto-navbar-symbol" alt="Home"> <img src="images/ditto_allwhite_textonly.svg" class="ditto-navbar-symbol-text" alt="Ditto"></a>
+ </div>
+ <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
+ <ul class="nav navbar-nav navbar-right">
+ <!-- toggle sidebar button -->
+ <!--<li><a id="tg-sb-link" href="#"><i id="tg-sb-icon" class="fa fa-toggle-on"></i> Nav</a></li>-->
+ <!-- entries without drop-downs appear here -->
+
+
+
+
+
+
+
+ <li><a href="blog.html">Blog</a></li>
+
+
+
+ <li><a href="intro-overview.html">Documentation</a></li>
+
+
+
+ <li><a href="http-api-doc.html">HTTP API</a></li>
+
+
+
+ <li><a href="https://ditto.eclipse.org" target="_blank">Sandbox</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">GitHub</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">GitHub examples</a></li>
+
+
+
+ <!-- entries with drop-downs appear here -->
+ <!-- conditional logic to control which topnav appears for the audience defined in the configuration file.-->
+
+
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Links<b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+
+ <li><a href="https://projects.eclipse.org/projects/iot.ditto" target="_blank">Eclipse Ditto Project</a></li>
+
+
+
+ <li><a href="https://www.eclipse.org/forums/index.php/f/364/" target="_blank">Forum</a></li>
+
+
+
+ <li><a href="https://ci.eclipse.org/ditto/" target="_blank">Jenkins</a></li>
+
+
+
+ <li><a href="https://dev.eclipse.org/mhonarc/lists/ditto-dev/" target="_blank">Mailing list archives</a></li>
+
+
+
+ <li><a href="https://gitter.im/eclipse/ditto" target="_blank">Gitter.im chat</a></li>
+
+
+ </ul>
+ </li>
+
+
+
+ <!--comment out this block if you want to hide search-->
+ <li>
+ <!--start search-->
+ <div id="search-demo-container">
+ <input type="text" id="search-input" placeholder="search...">
+ <ul id="results-container"></ul>
+ </div>
+ <script src="//cdnjs.cloudflare.com/ajax/libs/simple-jekyll-search/0.0.9/jekyll-search.js" type="text/javascript"></script>
+ <script type="text/javascript">
+ SimpleJekyllSearch.init({
+ searchInput: document.getElementById('search-input'),
+ resultsContainer: document.getElementById('results-container'),
+ dataSource: 'search.json',
+ searchResultTemplate: '<li><a href="{url}" title="Acknowledgements">{title}</a></li>',
+ noResultsText: 'No results found.',
+ limit: 10,
+ fuzzy: true,
+ })
+ </script>
+ <!--end search-->
+ </li>
+ </ul>
+ </div>
+ </div>
+ <!-- /.container -->
+</nav>
+
+<!-- Page Content -->
+<div class="container">
+ <div id="main">
+ <!-- Content Row -->
+ <div class="row">
+
+
+ <!-- Sidebar Column -->
+ <div class="col-md-3" id="tg-sb-sidebar">
+
+
+<ul id="mysidebar" class="nav">
+ <li class="sidebarTitle">
+ <label for="docVersion">Eclipse Ditto version:</label>
+ <div class="select-wrapper">
+ <select id="docVersion" name="docVersion">
+
+ <option value="">development</option>
+
+ <option value="1.0">1.0</option>
+
+ <option value="1.1">1.1</option>
+
+ </select>
+ </div>
+ <div id="dev-warning">
+ <div markdown="span" class="alert alert-warning" role="alert" style="font-size:0.6em"><i class="fa fa-warning"></i> <b>Important:</b> This documentation reflects the latest 'development'. You might want to choose a released version.</div>
+ </div>
+ </li>
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Introduction</a>
+ <ul>
+
+
+
+ <li><a href="intro-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="intro-digitaltwins.html">Digital twins</a></li>
+
+
+
+
+
+
+ <li><a href="intro-hello-world.html">Hello world</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Release Notes</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_100.html">1.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_090.html">0.9.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_080.html">0.8.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Milestone releases</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_100-M2.html">1.0.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_100-M1a.html">1.0.0-M1a</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M2.html">0.9.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M1.html">0.9.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M3.html">0.8.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M2.html">0.8.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M1.html">0.8.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M2.html">0.3.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M1.html">0.3.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_020-M1.html">0.2.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M3.html">0.1.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M1.html">0.1.0-M1</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Installation</a>
+ <ul>
+
+
+
+ <li><a href="installation-building.html">Building Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-running.html">Running Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-operating.html">Operating Ditto</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Basic concepts</a>
+ <ul>
+
+
+
+ <li><a href="basic-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Model entities</a>
+ <ul>
+
+
+
+ <li><a href="basic-thing.html">Thing</a></li>
+
+
+
+
+
+ <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
+
+
+
+
+
+ <li><a href="basic-feature.html">Feature</a></li>
+
+
+
+
+
+ <li><a href="basic-policy.html">Policy</a></li>
+
+
+
+
+
+ <li><a href="basic-namespaces-and-names.html">Namespaces and Names</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-auth.html">Authentication and Authorization</a></li>
+
+
+
+
+
+
+ <li><a href="basic-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="basic-signals.html">Signals</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Signal types</a>
+ <ul>
+
+
+
+ <li><a href="basic-signals-command.html">Command</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-commandresponse.html">Command response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-errorresponse.html">Error response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-event.html">Event</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-apis.html">APIs</a></li>
+
+
+
+
+
+
+ <li><a href="basic-connections.html">Connections</a></li>
+
+
+
+
+
+
+ <li><a href="basic-placeholders.html">Placeholders</a></li>
+
+
+
+
+
+
+ <li><a href="basic-changenotifications.html">Change notifications</a></li>
+
+
+
+
+
+
+ <li><a href="basic-rql.html">RQL expressions</a></li>
+
+
+
+
+
+
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
+ <li><a href="basic-search.html">Search</a></li>
+
+
+
+
+
+
+ <li class="active"><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Architecture</a>
+ <ul>
+
+
+
+ <li><a href="architecture-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Services</a>
+ <ul>
+
+
+
+ <li><a href="architecture-services-policies.html">Policies</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things.html">Things</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things-search.html">Things-Search</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-connectivity.html">Connectivity</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-concierge.html">Concierge</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-gateway.html">Gateway</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>HTTP API</a>
+ <ul>
+
+
+
+ <li><a href="httpapi-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-concepts.html">Concepts</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-protocol-bindings-websocket.html">WebSocket protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-sse.html">Server sent events</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Connectivity API</a>
+ <ul>
+
+
+
+ <li><a href="connectivity-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-manage-connections.html">Manage connections</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp091.html">AMQP 0.9.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp10.html">AMQP 1.0 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-kafka2.html">Kafka 2.x protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-mapping.html">Payload mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-header-mapping.html">Header mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-tls-certificates.html">TLS certificates</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Client SDK</a>
+ <ul>
+
+
+
+ <li><a href="client-sdk-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-java.html">Java</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-javascript.html">JavaScript</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Ditto Protocol</a>
+ <ul>
+
+
+
+ <li><a href="protocol-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-twinlive.html">Twin/live channel</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification.html">Specification</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-topic.html">Protocol topic</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-things.html">Things group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-delete.html">Delete</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ search/messages</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-search.html">Search</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-messages.html">Messages</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-bindings.html">Bindings</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-examples.html">Examples</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-creatething.html">Create a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletething.html">Delete a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifything.html">Modify a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievething.html">Retrieve a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethings.html">Retrieve multiple Things</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattributes.html">Delete Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattributes.html">Modify Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattributes.html">Retrieve Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattribute.html">Create a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattribute.html">Delete a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattribute.html">Modify a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattribute.html">Retrieve a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createthingdefinition.html">Create a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletethingdefinition.html">Delete a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifythingdefinition.html">Modify a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethingdefinition.html">Retrieve a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeatures.html">Create Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeatures.html">Delete Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeatures.html">Modify Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeatures.html">Retrieve Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeature.html">Create a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeature.html">Delete a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeature.html">Modify a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeature.html">Retrieve a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdefinition.html">Create Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedefinition.html">Delete Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydefinition.html">Modify Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedefinition.html">Retrieve Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperties.html">Create Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperties.html">Delete Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperties.html">Modify Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperties.html">Retrieve Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperty.html">Create a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperty.html">Delete a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperty.html">Modify a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperty.html">Retrieve a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li><a href="sandbox.html">Sandbox</a></li>
+
+
+
+
+
+ <li><a href="presentations.html">Presentations</a></li>
+
+
+
+
+
+ <li><a href="glossary.html">Glossary</a></li>
+
+
+
+
+
+ <li><a href="feedback.html">Feedback</a></li>
+
+
+
+
+
+ <p class="external">
+ <a href="#" id="collapseAll">Collapse All</a> | <a href="#" id="expandAll">Expand All</a>
+ </p>
+
+</ul>
+
+<!-- this highlights the active parent class in the sidebar. this is critical so that the parent expands when you're viewing a page. This must appear below the sidebar code above. Otherwise, if placed inside customscripts.js, the script runs before the sidebar code runs and the class never gets inserted.-->
+<script>$("li.active").parents('li').toggleClass("active");
+
+$(function() {
+ $("#dev-warning").hide();
+ changeSelectedDocVersionDropdownSelection($("#docVersion")[0]);
+ $("#docVersion").change(changeSelectedDocVersion);
+});
+
+function changeSelectedDocVersionDropdownSelection(element) {
+ var pathName = window.location.pathname;
+
+ var versionOptions = element.options;
+ for (var i = 0; i < versionOptions.length; i++) {
+ var versionValue = versionOptions[i].value;
+ if ((versionValue !== "") && pathName.startsWith("/ditto/"+versionValue+"/")) {
+ $("#docVersion").val(versionValue).change();
+ return;
+ }
+ }
+ // fallback: dev with "empty" version value:
+ $("#docVersion").val("").change();
+ $("#dev-warning").show();
+}
+function changeSelectedDocVersion() {
+ var versionValue = $('#docVersion').val();
+ var remainingPath = window.location.pathname.replace("/ditto/", "");
+ var versionMatch = remainingPath.match("([0-9].[0.9])/(.*)");
+ if (versionValue === "" && !versionMatch) {
+ // do nothing, we're already on the correct "dev" version
+ } else if (versionMatch && (versionValue === versionMatch[1])) {
+ // do nothing, we're already on the correct version
+ } else {
+ if (versionValue === "" && versionMatch) {
+ window.location.pathname = "ditto/" + versionMatch[2];
+ } else if (versionValue === "") {
+ window.location.pathname = "ditto/" + remainingPath;
+ } else if (versionMatch) {
+ window.location.pathname = "ditto/" + versionValue + "/" + versionMatch[2];
+ } else {
+ window.location.pathname = "ditto/" + versionValue + "/" + remainingPath;
+ }
+ }
+}
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Acknowledgements</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+
+
+
+<!-- this handles the automatic toc. use ## for subheads to auto-generate the on-page minitoc. if you use html tags, you must supply an ID for the heading element in order for it to appear in the minitoc. -->
+<script>
+$( document ).ready(function() {
+ // Handler for .ready() called.
+
+$('#toc').toc({ minimumHeaders: 0, listType: 'ul', showSpeed: 0, headers: 'h2,h3,h4' });
+
+/* this offset helps account for the space taken up by the floating toolbar. */
+$('#toc').on('click', 'a', function() {
+ var target = $(this.getAttribute('href'))
+ , scroll_target = target.offset().top
+
+ $(window).scrollTop(scroll_target - 10);
+ return false
+})
+
+});
+</script>
+
+<div id="toc"></div>
+
+
+
+
+
+
+
+
+
+ <div class="bs-callout bs-callout-primary">Available since Ditto <strong>1.1.0</strong></div>
+
+<p>Acknowledgements are a concept in Ditto used to signal that an <a href="basic-signals-event.html">event</a> was successfully
+received/processed by either an internal Ditto functionality or an external subscriber of that event.</p>
+
+<p>They can be seen as (potentially multiple) responses to a single event (e.g. after a Thing was modified).</p>
+
+<p>Acknowledgements can be used in order to solve the following cases:</p>
+<ul>
+ <li>postpone a response to an API request (e.g. block an HTTP request) until one or more specific actions were performed in
+Ditto (e.g. a modification was successfully persisted).</li>
+ <li>postpone a response until an external subscriber connected to Ditto reports that he successfully processed an
+<a href="basic-signals-event.html">event</a> which e.g. resulted by a persistence change of Ditto.</li>
+ <li><em>Outlook</em> (to come in Ditto 1.2.0): provide a QoS (quality of service) guarantee of “at least once” when processing
+messages in an end-2-end manner by e.g. technically acknowledging/settling a processed message from a message broker
+(e.g. <a href="connectivity-protocol-bindings-amqp10.html">AMQP 1.0</a> or <a href="connectivity-protocol-bindings-mqtt.html">MQTT</a>) only
+after it was successfully applied to Ditto and potentially also to 3rd parties.</li>
+</ul>
+
+<h2 id="acknowledgement-requests">Acknowledgement requests</h2>
+
+<p>For each Ditto API invocation <em>modifying the state of a twin</em> with a <a href="basic-signals-command.html">command</a> it is
+possible to define that certain “acknowledgements” are <em>requested</em>.<br />
+This means that the Ditto collects all of those requested acknowledgements until the message is handled as successfully
+processed, applying a specified timeout interval.</p>
+
+<p>Acknowledgement requests are expressed as protocol specific header fields of commands, more on that
+<a href="#requesting-acknowledgements">later</a>.</p>
+
+<p>The <a href="basic-signals-event.html">events</a> emitted by Ditto will include the custom acknowledgement requests in the
+<code class="highlighter-rouge">"requested-acks"</code> header.</p>
+
+<h2 id="acknowledgement-labels">Acknowledgement labels</h2>
+
+<p>Acknowledgement labels identify the acknowledgement. Some labels are already engaged by Ditto for other purposes,
+and may therefore not be used when sending back a custom acknowledgement.</p>
+
+<h3 id="built-in-acknowledgement-labels">Built-in acknowledgement labels</h3>
+
+<p>Ditto provides built-in acknowledgements that are automatically issued on certain actions in the Ditto cluster:</p>
+<ul>
+ <li><strong>twin-persisted</strong>: An acknowledgement with this label is issued, when a modifying command has successfully
+updated the digital twin in Ditto’s persistence.</li>
+</ul>
+
+<h3 id="custom-acknowledgement-labels">Custom acknowledgement labels</h3>
+
+<p>In addition to the <a href="#built-in-acknowledgement-labels">built-in</a> acknowledgement requests,
+a received <a href="basic-signals-event.html">event</a> can contain
+custom acknowledgement labels.
+The event subscriber can detect that an acknowledgement was requested
+(via the <code class="highlighter-rouge">"requested-acks"</code> header), and - as far as it feels responsible for handling it - it<br />
+<a href="#issuing-acknowledgements">issues an acknowledgement</a>.</p>
+
+<h2 id="acknowledgements">Acknowledgements</h2>
+
+<p>A single acknowledgement contains the following information:</p>
+<ul>
+ <li>Acknowledgement label (one of the requested labels of the <a href="#acknowledgement-requests">ack requests</a> of e.g. an event)</li>
+ <li>Header fields
+ <ul>
+ <li>mandatory: <strong>correlation-id</strong> the same correlation-id as the one of the event which requested the acknowledgement</li>
+ <li>optional: additional header fields</li>
+ </ul>
+ </li>
+ <li>Status code (HTTP status code semantic) defining whether an acknowledgement was successful or not</li>
+ <li>Optional payload as JSON</li>
+</ul>
+
+<p>The <a href="protocol-specification-acks.html">Ditto Protocol specification</a> describes in detail what is contained.<br />
+An example of how acknowledgements in Ditto Protocol look like can be found at the
+<a href="protocol-examples.html#acknowledgements-acks">acknowledgements acks examples</a> section.</p>
+
+<h2 id="requesting-acknowledgements">Requesting acknowledgements</h2>
+
+<p>With every API call <em>modifying the state of a twin</em> there is the option to provide requested acknowledgements.</p>
+
+<h3 id="via-http">Via HTTP</h3>
+
+<p>Either specify the following HTTP header fields:</p>
+<ul>
+ <li><strong>requested-acks</strong>: a comma separated list of <a href="#acknowledgement-labels">acknowledgement labels</a><br />
+ Example: <em>requested-acks</em>: twin-persisted,my-custom-ack</li>
+ <li>timeout: an optional time (in ms, s or m) of how long the HTTP request should wait for acknowledgements and block. Default: <code class="highlighter-rouge">60s</code><br />
+ Examples: <em>timeout</em>: <code class="highlighter-rouge">42s</code>, <em>timeout</em>: <code class="highlighter-rouge">250ms</code>, <em>timeout</em>: <code class="highlighter-rouge">1m</code></li>
+</ul>
+
+<p>Or specify the header fields as query parameters to the HTTP params, e.g.:</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>PUT /api/2/things/org.eclipse.ditto:thing-1?requested-acks=twin-persisted,my-custom-ack&timeout=42s
+</code></pre></div></div>
+
+<p>The response of an HTTP request, which requested several acknowledgements, will differ from the response,
+where an HTTP request was not requesting acknowledgements.</p>
+
+<p>Example response when 2 acknowledgements were requested and were successful. The overall HTTP status code will be
+<code class="highlighter-rouge">200</code> (OK) in this case:</p>
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"twin-persisted"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">201</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"payload"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"thingId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto:thing-1"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"policyId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto:thing-1"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"db878735-4957-4fd9-92dc-6f09bb12a093"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"version"</span><span class="p">:</span><span class="w"> </span><span class="mi">2</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"etag"</span><span class="p">:</span><span class="w"> </span><span class="s2">"</span><span class="se">\"</span><span class="s2">rev:1</span><span class="se">\"</span><span class="s2">"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"location"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://127.0.0.1:8080/api/2/things/org.eclipse.ditto:thing-1"</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"my-custom-ack"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">200</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"payload"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"outcome"</span><span class="p">:</span><span class="w"> </span><span class="s2">"green"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"version"</span><span class="p">:</span><span class="w"> </span><span class="mi">2</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"db878735-4957-4fd9-92dc-6f09bb12a093"</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<p>Example response when 2 acknowledgements were requested and one lead to a timeout. The overall HTTP status code will be
+<code class="highlighter-rouge">424</code> (Dependency failed) in this case:</p>
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"twin-persisted"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">201</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"payload"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"thingId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto:thing-1"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"policyId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto:thing-1"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"db878735-4957-4fd9-92dc-6f09bb12a093"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"version"</span><span class="p">:</span><span class="w"> </span><span class="mi">2</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"etag"</span><span class="p">:</span><span class="w"> </span><span class="s2">"</span><span class="se">\"</span><span class="s2">rev:1</span><span class="se">\"</span><span class="s2">"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"location"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://127.0.0.1:8080/api/2/things/org.eclipse.ditto:thing-1"</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"my-custom-ack"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">408</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"payload"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">408</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"error"</span><span class="p">:</span><span class="w"> </span><span class="s2">"acknowledgement:request.timeout"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"message"</span><span class="p">:</span><span class="w"> </span><span class="s2">"The acknowledgement request reached the specified timeout of 42,000ms."</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"description"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Try increasing the timeout and make sure that the requested acknowledgement is sent back in time."</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"version"</span><span class="p">:</span><span class="w"> </span><span class="mi">2</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"db878735-4957-4fd9-92dc-6f09bb12a093"</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h3 id="via-websocket">Via WebSocket</h3>
+
+<p>Put the <code class="highlighter-rouge">"requested-acks"</code> (as JsonArray of strings) and the <code class="highlighter-rouge">"timeout"</code> headers in the
+<a href="protocol-specification.html#headers">Ditto Protocol headers</a> section of Ditto Protocol JSON.</p>
+
+<p>The response will be an <a href="protocol-specification-acks.html">acknowledgements</a> message.</p>
+
+<h3 id="via-connections">Via Connections</h3>
+
+<p>For messages received by connections via AMQP, MQTT, etc. put the <code class="highlighter-rouge">"requested-acks"</code> (as JsonArray of strings) and the
+<code class="highlighter-rouge">"timeout"</code> headers in the <a href="protocol-specification.html#headers">Ditto Protocol headers</a> section of Ditto Protocol JSON.</p>
+
+<p>The response will be an (aggregating) <a href="protocol-specification-acks.html#acknowledgements-aggregating">acknowledgements</a>
+message.</p>
+
+<h2 id="issuing-acknowledgements">Issuing acknowledgements</h2>
+
+<p>In order to issue a single acknowledgement when requested by a published event, an
+<a href="protocol-specification-acks.html#acknowledgement">Ditto Protocol acknowledgement</a> message has to be built and sent
+back, using the same <code class="highlighter-rouge">"correlation-id"</code> in the <a href="protocol-specification.html#headers">protocol headers</a> as the event
+contained.</p>
+
+
+ <div class="tags">
+
+ <b>Tags: </b>
+
+
+
+ <a href="tag_model.html" class="btn btn-default navbar-btn cursorNorm" role="button">model</a>
+
+
+
+ </div>
+
+</div>
+
+<hr class="shaded"/>
+
+<footer>
+ <div class="row">
+ <div class="col-lg-12 footer">
+ <div class="logo">
+ <a href="https://eclipse.org"><img src="images/eclipse_foundation_logo.svg" alt="Eclipse logo"/></a>
+ </div>
+ <p class="notice">
+ ©2020 Eclipse Ditto.
+ Site last generated: Jul 1, 2020 <br />
+ </p>
+ <div class="quickLinks">
+ <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
+ > Privacy Policy
+ </a>
+ <a href="https://www.eclipse.org/legal/termsofuse.php" target="_blank">
+ > Terms of Use
+ </a>
+ <a href="https://www.eclipse.org/legal/copyright.php" target="_blank">
+ > Copyright Agent
+ </a>
+ <a href="https://www.eclipse.org/legal" target="_blank">
+ > Legal
+ </a>
+ <a href="https://www.eclipse.org/legal/epl-2.0/" target="_blank">
+ > License
+ </a>
+ <a href="https://eclipse.org/security" target="_blank">
+ > Report a Vulnerability
+ </a>
+ </div>
+ </div>
+ </div>
+</footer>
+
+
+ </div>
+ <!-- /.row -->
+</div>
+<!-- /.container -->
+</div>
+<!-- /#main -->
+ </div>
+
+</body>
+</html>
diff --git a/1.0/basic-acl.html b/1.0/basic-acl.html
index fe0bb57..f22d0c5 100644
--- a/1.0/basic-acl.html
+++ b/1.0/basic-acl.html
@@ -6,7 +6,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="description" content="">
<meta name="keywords" content="model, authentication, authorization, auth, acl, access control">
-<title> Access control list (ACL) • Eclipse Ditto • a digital twin framework</title>
+<title> Access control list (ACL) - Deprecated • Eclipse Ditto • a digital twin framework</title>
<link rel="stylesheet" href="css/syntax.css">
<link rel="stylesheet" type="text/css" href="//cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css" crossorigin="anonymous">
@@ -167,7 +167,7 @@
searchInput: document.getElementById('search-input'),
resultsContainer: document.getElementById('results-container'),
dataSource: 'search.json',
- searchResultTemplate: '<li><a href="{url}" title="Access control list (ACL)">{title}</a></li>',
+ searchResultTemplate: '<li><a href="{url}" title="Access control list (ACL) - Deprecated">{title}</a></li>',
noResultsText: 'No results found.',
limit: 10,
fuzzy: true,
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1208,7 +1429,7 @@
<!-- Content Column -->
<div class="col-md-9" id="tg-sb-content">
<div class="post-header">
- <h1 class="post-title-main">Access control list (ACL)</h1>
+ <h1 class="post-title-main">Access control list (ACL) - Deprecated</h1>
</div>
@@ -1339,7 +1560,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/basic-apis.html b/1.0/basic-apis.html
index fda7958..fcd8b63 100644
--- a/1.0/basic-apis.html
+++ b/1.0/basic-apis.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1397,7 +1618,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/basic-auth.html b/1.0/basic-auth.html
index 4172014..c795a8a 100644
--- a/1.0/basic-auth.html
+++ b/1.0/basic-auth.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1269,10 +1490,10 @@
<p>A user who calls the HTTP API can be authenticated using two mechanisms:</p>
<ul>
- <li>HTTP BASIC Authentication by providing username and password of users managed within for example nginx acting as
-reverse proxy.</li>
+ <li>Pre-authentication by an HTTP reverse proxy in front of Ditto, e.g. doing HTTP BASIC Authentication by providing
+username and password as <a href="installation-operating.html#pre-authentication">documented in the installation/operation guide</a>.</li>
<li>A <a href="#" data-toggle="tooltip" data-original-title="JSON Web Token (JWT)">JWT</a> issued by Google or other
-OpenID Connect providers.</li>
+OpenID Connect providers as <a href="installation-operating.html#openid-connect">documented in the installation/operation guide</a>.</li>
</ul>
<h2 id="authorization">Authorization</h2>
@@ -1283,6 +1504,16 @@
<p>Please find details at <a href="basic-acl.html">ACL</a> and <a href="basic-policy.html">Policies</a>.</p>
+<h3 id="authorization-context-in-devops-commands">Authorization Context in DevOps Commands</h3>
+
+<p>An <code class="highlighter-rouge">authorizationContext</code> which is passed to <a href="installation-operating.html#devops-commands">DevOps Commands</a> needs
+to be a subject known to Ditto’s authentication. In the simplest case, it’s <code class="highlighter-rouge">nginx:{username}</code> where <code class="highlighter-rouge">{username}</code> is a user
+that is configured for basic auth in the included nginx’s <code class="highlighter-rouge">nginx.htpasswd</code> file (where the <code class="highlighter-rouge">nginx:</code> prefix comes from).</p>
+
+<p>If you are using the provided docker quickstart example from <a href="installation-running.html">Getting Started</a> you
+can simply use <code class="highlighter-rouge">nginx:ditto</code>, then the commands that are passed from the connection are executed as if they
+were issued via HTTP from the user <code class="highlighter-rouge">ditto</code>.</p>
+
<div class="tags">
@@ -1308,7 +1539,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/basic-changenotifications.html b/1.0/basic-changenotifications.html
index ba0bdea..d09c8aa 100644
--- a/1.0/basic-changenotifications.html
+++ b/1.0/basic-changenotifications.html
@@ -5,7 +5,7 @@
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="description" content="">
-<meta name="keywords" content="modelrql, change, event, feature, notification, thing, filtering, rql, push, subscribe, consume">
+<meta name="keywords" content="modelrql, change, event, feature, notification, thing, filtering, rql, push, subscribe, consume, enrich, extra">
<title> Change notifications • Eclipse Ditto • a digital twin framework</title>
<link rel="stylesheet" href="css/syntax.css">
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1341,7 +1562,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/basic-connections.html b/1.0/basic-connections.html
index d2c5daa..8f32293 100644
--- a/1.0/basic-connections.html
+++ b/1.0/basic-connections.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1282,6 +1503,7 @@
<li><a href="connectivity-protocol-bindings-amqp091.html">AMQP 0.9.1</a></li>
<li><a href="connectivity-protocol-bindings-amqp10.html">AMQP 1.0</a></li>
<li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1</a></li>
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5</a></li>
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1</a></li>
<li><a href="connectivity-protocol-bindings-kafka2.html">Kafka 2.x</a></li>
</ul>
@@ -1400,6 +1622,10 @@
</span><span class="p">}</span><span class="w">
</span></code></pre></div></div>
+<p>Note: This example assumes that there is a valid user named <code class="highlighter-rouge">ditto:inbound-auth-subject</code> in Ditto.
+If you want to use a user for the basic auth (from the <a href="connectivity-protocol-bindings-http.html">HTTP API</a>) use the prefix <code class="highlighter-rouge">nginx:</code>, e.g. <code class="highlighter-rouge">nginx:ditto</code>.
+See <a href="basic-auth.html#authorization-context-in-devops-commands">Basic Authentication</a> for more information.</p>
+
<h4 id="source-header-mapping">Source header mapping</h4>
<p>For incoming messages, an optional <a href="connectivity-header-mapping.html">header mapping</a> may be applied.
@@ -1472,8 +1698,8 @@
<tr>
<th>Description</th>
<th>Topic</th>
- <th>Filter by namespaces</th>
- <th>Filter by RQL expression</th>
+ <th><a href="basic-changenotifications.html#by-namespaces">Filter by namespaces</a></th>
+ <th><a href="basic-changenotifications.html#by-rql-expression">Filter by RQL expression</a></th>
</tr>
</thead>
<tbody>
@@ -1514,12 +1740,63 @@
</span><span class="s2">"address"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<target-address>"</span><span class="p">,</span><span class="w">
</span><span class="s2">"topics"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
</span><span class="s2">"_/_/things/twin/events?namespaces=org.eclipse.ditto&filter=gt(attributes/counter,42)"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"_/_/things/twin/events?extraFields=attributes/placement&filter=gt(attributes/placement,'Kitchen')"</span><span class="p">,</span><span class="w">
</span><span class="s2">"_/_/things/live/messages?namespaces=org.eclipse.ditto"</span><span class="w">
</span><span class="p">],</span><span class="w">
</span><span class="s2">"authorizationContext"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">"ditto:outbound-auth-subject"</span><span class="p">,</span><span class="w"> </span><span class="s2">"..."</span><span class="p">]</span><span class="w">
</span><span class="p">}</span><span class="w">
</span></code></pre></div></div>
+<h4 id="target-topics-and-enrichment">Target topics and enrichment</h4>
+
+<div class="bs-callout bs-callout-primary">Available since Ditto <strong>1.1.0</strong></div>
+
+<p>When extra fields should be added to outgoing messages on a connection, an <code class="highlighter-rouge">extraFields</code> parameter can be added
+to the topic. This is supported for all topics:</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Description</th>
+ <th>Topic</th>
+ <th><a href="basic-enrichment.html">Enrich by extra fields</a></th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>Subscribe for <a href="basic-changenotifications.html">events/change notifications</a></td>
+ <td><code class="highlighter-rouge">_/_/things/twin/events</code></td>
+ <td>✔</td>
+ </tr>
+ <tr>
+ <td>Subscribe for <a href="basic-messages.html">messages</a></td>
+ <td><code class="highlighter-rouge">_/_/things/live/messages</code></td>
+ <td>✔</td>
+ </tr>
+ <tr>
+ <td>Subscribe for <a href="protocol-twinlive.html">live commands</a></td>
+ <td><code class="highlighter-rouge">_/_/things/live/commands</code></td>
+ <td>✔</td>
+ </tr>
+ <tr>
+ <td>Subscribe for <a href="protocol-twinlive.html">live events</a></td>
+ <td><code class="highlighter-rouge">_/_/things/live/events</code></td>
+ <td>✔</td>
+ </tr>
+ </tbody>
+</table>
+
+<p>Example:</p>
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"address"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<target-address>"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"topics"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
+ </span><span class="s2">"_/_/things/twin/events?extraFields=attributes/placement"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"_/_/things/live/messages?extraFields=features/ConnectionStatus"</span><span class="w">
+ </span><span class="p">],</span><span class="w">
+ </span><span class="s2">"authorizationContext"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">"ditto:outbound-auth-subject"</span><span class="p">,</span><span class="w"> </span><span class="s2">"..."</span><span class="p">]</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
<h4 id="target-header-mapping">Target header mapping</h4>
<p>For outgoing messages, an optional <a href="connectivity-header-mapping.html">header mapping</a> may be applied.
@@ -1680,7 +1957,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/basic-enrichment.html b/1.0/basic-enrichment.html
new file mode 100644
index 0000000..708c511
--- /dev/null
+++ b/1.0/basic-enrichment.html
@@ -0,0 +1,1634 @@
+<!DOCTYPE html>
+<html>
+<head>
+ <meta charset="utf-8">
+<meta http-equiv="X-UA-Compatible" content="IE=edge">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="description" content="">
+<meta name="keywords" content="protocol, change, event, enrich, extra, enrichment, fields, extraFields">
+<title> Signal enrichment • Eclipse Ditto • a digital twin framework</title>
+
+<link rel="stylesheet" href="css/syntax.css">
+<link rel="stylesheet" type="text/css" href="//cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/modern-business.css">
+<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/customstyles.css">
+<link rel="stylesheet" href="css/boxshadowproperties.css">
+<link rel="stylesheet" href="css/theme-ditto.css">
+<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:400,700|Source+Code+Pro:300,600|Titillium+Web:400,600,700">
+
+<script src="//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.4/jquery.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/js/bootstrap.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/anchor-js/2.0.0/anchor.min.js" crossorigin="anonymous"></script>
+<script src="js/toc.js"></script>
+<script src="js/customscripts.js"></script>
+
+<script type="application/ld+json">
+{
+ "@context": "http://schema.org",
+ "@type": "Organization",
+ "url": "https://eclipse.org/ditto/",
+ "logo": "https://eclipse.org/ditto/images/ditto.svg"
+}
+</script>
+
+<link rel="icon" type="image/png" href="images/favicon-16x16.png" sizes="16x16">
+<link rel="icon" type="image/png" href="images/favicon-32x32.png" sizes="32x32">
+<link rel="icon" type="image/png" href="images/favicon-96x96.png" sizes="96x96">
+
+<link rel="alternate" type="application/rss+xml" title="Eclipse Ditto Blog" href="https://www.eclipse.org/ditto/feed.xml">
+
+<!-- Eclipse Foundation cookie consent: -->
+<link rel="stylesheet" type="text/css" href="//www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css" />
+<script src="//www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+ <script>
+ $(document).ready(function() {
+ $("#tg-sb-link").click(function() {
+ $("#tg-sb-sidebar").toggle();
+ $("#tg-sb-content").toggleClass('col-md-9');
+ $("#tg-sb-content").toggleClass('col-md-12');
+ $("#tg-sb-icon").toggleClass('fa-toggle-on');
+ $("#tg-sb-icon").toggleClass('fa-toggle-off');
+ });
+ });
+ </script>
+</head>
+
+
+<script>
+ (function(w,d,s,l,i){
+ w[l]=w[l]||[];
+ w[l].push({'gtm.start':
+ new Date().getTime(),event:'gtm.js'});
+ var f=d.getElementsByTagName(s)[0],
+ j=d.createElement(s),
+ dl=l!='dataLayer'?'&l='+l:'';
+ j.async=true;
+ j.src='https://www.googletagmanager.com/gtm.js?id='+i+dl;
+ f.parentNode.insertBefore(j,f);
+ })(window,document,'script','dataLayer','GTM-5WLCZXC');
+</script>
+
+
+
+<body>
+<!-- Navigation -->
+<nav class="navbar navbar-inverse navbar-fixed-top">
+ <div class="container topnavlinks">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-ditto-home" href="index.html"> <img src="images/ditto_allwhite_symbolonly.svg" class="ditto-navbar-symbol" alt="Home"> <img src="images/ditto_allwhite_textonly.svg" class="ditto-navbar-symbol-text" alt="Ditto"></a>
+ </div>
+ <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
+ <ul class="nav navbar-nav navbar-right">
+ <!-- toggle sidebar button -->
+ <!--<li><a id="tg-sb-link" href="#"><i id="tg-sb-icon" class="fa fa-toggle-on"></i> Nav</a></li>-->
+ <!-- entries without drop-downs appear here -->
+
+
+
+
+
+
+
+ <li><a href="blog.html">Blog</a></li>
+
+
+
+ <li><a href="intro-overview.html">Documentation</a></li>
+
+
+
+ <li><a href="http-api-doc.html">HTTP API</a></li>
+
+
+
+ <li><a href="https://ditto.eclipse.org" target="_blank">Sandbox</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">GitHub</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">GitHub examples</a></li>
+
+
+
+ <!-- entries with drop-downs appear here -->
+ <!-- conditional logic to control which topnav appears for the audience defined in the configuration file.-->
+
+
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Links<b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+
+ <li><a href="https://projects.eclipse.org/projects/iot.ditto" target="_blank">Eclipse Ditto Project</a></li>
+
+
+
+ <li><a href="https://www.eclipse.org/forums/index.php/f/364/" target="_blank">Forum</a></li>
+
+
+
+ <li><a href="https://ci.eclipse.org/ditto/" target="_blank">Jenkins</a></li>
+
+
+
+ <li><a href="https://dev.eclipse.org/mhonarc/lists/ditto-dev/" target="_blank">Mailing list archives</a></li>
+
+
+
+ <li><a href="https://gitter.im/eclipse/ditto" target="_blank">Gitter.im chat</a></li>
+
+
+ </ul>
+ </li>
+
+
+
+ <!--comment out this block if you want to hide search-->
+ <li>
+ <!--start search-->
+ <div id="search-demo-container">
+ <input type="text" id="search-input" placeholder="search...">
+ <ul id="results-container"></ul>
+ </div>
+ <script src="//cdnjs.cloudflare.com/ajax/libs/simple-jekyll-search/0.0.9/jekyll-search.js" type="text/javascript"></script>
+ <script type="text/javascript">
+ SimpleJekyllSearch.init({
+ searchInput: document.getElementById('search-input'),
+ resultsContainer: document.getElementById('results-container'),
+ dataSource: 'search.json',
+ searchResultTemplate: '<li><a href="{url}" title="Signal enrichment">{title}</a></li>',
+ noResultsText: 'No results found.',
+ limit: 10,
+ fuzzy: true,
+ })
+ </script>
+ <!--end search-->
+ </li>
+ </ul>
+ </div>
+ </div>
+ <!-- /.container -->
+</nav>
+
+<!-- Page Content -->
+<div class="container">
+ <div id="main">
+ <!-- Content Row -->
+ <div class="row">
+
+
+ <!-- Sidebar Column -->
+ <div class="col-md-3" id="tg-sb-sidebar">
+
+
+<ul id="mysidebar" class="nav">
+ <li class="sidebarTitle">
+ <label for="docVersion">Eclipse Ditto version:</label>
+ <div class="select-wrapper">
+ <select id="docVersion" name="docVersion">
+
+ <option value="">development</option>
+
+ <option value="1.0">1.0</option>
+
+ <option value="1.1">1.1</option>
+
+ </select>
+ </div>
+ <div id="dev-warning">
+ <div markdown="span" class="alert alert-warning" role="alert" style="font-size:0.6em"><i class="fa fa-warning"></i> <b>Important:</b> This documentation reflects the latest 'development'. You might want to choose a released version.</div>
+ </div>
+ </li>
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Introduction</a>
+ <ul>
+
+
+
+ <li><a href="intro-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="intro-digitaltwins.html">Digital twins</a></li>
+
+
+
+
+
+
+ <li><a href="intro-hello-world.html">Hello world</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Release Notes</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_100.html">1.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_090.html">0.9.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_080.html">0.8.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Milestone releases</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_100-M2.html">1.0.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_100-M1a.html">1.0.0-M1a</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M2.html">0.9.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M1.html">0.9.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M3.html">0.8.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M2.html">0.8.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M1.html">0.8.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M2.html">0.3.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M1.html">0.3.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_020-M1.html">0.2.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M3.html">0.1.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M1.html">0.1.0-M1</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Installation</a>
+ <ul>
+
+
+
+ <li><a href="installation-building.html">Building Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-running.html">Running Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-operating.html">Operating Ditto</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Basic concepts</a>
+ <ul>
+
+
+
+ <li><a href="basic-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Model entities</a>
+ <ul>
+
+
+
+ <li><a href="basic-thing.html">Thing</a></li>
+
+
+
+
+
+ <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
+
+
+
+
+
+ <li><a href="basic-feature.html">Feature</a></li>
+
+
+
+
+
+ <li><a href="basic-policy.html">Policy</a></li>
+
+
+
+
+
+ <li><a href="basic-namespaces-and-names.html">Namespaces and Names</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-auth.html">Authentication and Authorization</a></li>
+
+
+
+
+
+
+ <li><a href="basic-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="basic-signals.html">Signals</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Signal types</a>
+ <ul>
+
+
+
+ <li><a href="basic-signals-command.html">Command</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-commandresponse.html">Command response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-errorresponse.html">Error response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-event.html">Event</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-apis.html">APIs</a></li>
+
+
+
+
+
+
+ <li><a href="basic-connections.html">Connections</a></li>
+
+
+
+
+
+
+ <li><a href="basic-placeholders.html">Placeholders</a></li>
+
+
+
+
+
+
+ <li><a href="basic-changenotifications.html">Change notifications</a></li>
+
+
+
+
+
+
+ <li><a href="basic-rql.html">RQL expressions</a></li>
+
+
+
+
+
+
+ <li class="active"><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
+ <li><a href="basic-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Architecture</a>
+ <ul>
+
+
+
+ <li><a href="architecture-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Services</a>
+ <ul>
+
+
+
+ <li><a href="architecture-services-policies.html">Policies</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things.html">Things</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things-search.html">Things-Search</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-connectivity.html">Connectivity</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-concierge.html">Concierge</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-gateway.html">Gateway</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>HTTP API</a>
+ <ul>
+
+
+
+ <li><a href="httpapi-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-concepts.html">Concepts</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-protocol-bindings-websocket.html">WebSocket protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-sse.html">Server sent events</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Connectivity API</a>
+ <ul>
+
+
+
+ <li><a href="connectivity-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-manage-connections.html">Manage connections</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp091.html">AMQP 0.9.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp10.html">AMQP 1.0 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-kafka2.html">Kafka 2.x protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-mapping.html">Payload mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-header-mapping.html">Header mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-tls-certificates.html">TLS certificates</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Client SDK</a>
+ <ul>
+
+
+
+ <li><a href="client-sdk-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-java.html">Java</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-javascript.html">JavaScript</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Ditto Protocol</a>
+ <ul>
+
+
+
+ <li><a href="protocol-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-twinlive.html">Twin/live channel</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification.html">Specification</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-topic.html">Protocol topic</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-things.html">Things group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-delete.html">Delete</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ search/messages</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-search.html">Search</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-messages.html">Messages</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-bindings.html">Bindings</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-examples.html">Examples</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-creatething.html">Create a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletething.html">Delete a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifything.html">Modify a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievething.html">Retrieve a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethings.html">Retrieve multiple Things</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattributes.html">Delete Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattributes.html">Modify Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattributes.html">Retrieve Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattribute.html">Create a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattribute.html">Delete a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattribute.html">Modify a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattribute.html">Retrieve a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createthingdefinition.html">Create a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletethingdefinition.html">Delete a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifythingdefinition.html">Modify a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethingdefinition.html">Retrieve a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeatures.html">Create Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeatures.html">Delete Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeatures.html">Modify Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeatures.html">Retrieve Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeature.html">Create a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeature.html">Delete a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeature.html">Modify a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeature.html">Retrieve a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdefinition.html">Create Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedefinition.html">Delete Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydefinition.html">Modify Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedefinition.html">Retrieve Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperties.html">Create Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperties.html">Delete Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperties.html">Modify Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperties.html">Retrieve Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperty.html">Create a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperty.html">Delete a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperty.html">Modify a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperty.html">Retrieve a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li><a href="sandbox.html">Sandbox</a></li>
+
+
+
+
+
+ <li><a href="presentations.html">Presentations</a></li>
+
+
+
+
+
+ <li><a href="glossary.html">Glossary</a></li>
+
+
+
+
+
+ <li><a href="feedback.html">Feedback</a></li>
+
+
+
+
+
+ <p class="external">
+ <a href="#" id="collapseAll">Collapse All</a> | <a href="#" id="expandAll">Expand All</a>
+ </p>
+
+</ul>
+
+<!-- this highlights the active parent class in the sidebar. this is critical so that the parent expands when you're viewing a page. This must appear below the sidebar code above. Otherwise, if placed inside customscripts.js, the script runs before the sidebar code runs and the class never gets inserted.-->
+<script>$("li.active").parents('li').toggleClass("active");
+
+$(function() {
+ $("#dev-warning").hide();
+ changeSelectedDocVersionDropdownSelection($("#docVersion")[0]);
+ $("#docVersion").change(changeSelectedDocVersion);
+});
+
+function changeSelectedDocVersionDropdownSelection(element) {
+ var pathName = window.location.pathname;
+
+ var versionOptions = element.options;
+ for (var i = 0; i < versionOptions.length; i++) {
+ var versionValue = versionOptions[i].value;
+ if ((versionValue !== "") && pathName.startsWith("/ditto/"+versionValue+"/")) {
+ $("#docVersion").val(versionValue).change();
+ return;
+ }
+ }
+ // fallback: dev with "empty" version value:
+ $("#docVersion").val("").change();
+ $("#dev-warning").show();
+}
+function changeSelectedDocVersion() {
+ var versionValue = $('#docVersion').val();
+ var remainingPath = window.location.pathname.replace("/ditto/", "");
+ var versionMatch = remainingPath.match("([0-9].[0.9])/(.*)");
+ if (versionValue === "" && !versionMatch) {
+ // do nothing, we're already on the correct "dev" version
+ } else if (versionMatch && (versionValue === versionMatch[1])) {
+ // do nothing, we're already on the correct version
+ } else {
+ if (versionValue === "" && versionMatch) {
+ window.location.pathname = "ditto/" + versionMatch[2];
+ } else if (versionValue === "") {
+ window.location.pathname = "ditto/" + remainingPath;
+ } else if (versionMatch) {
+ window.location.pathname = "ditto/" + versionValue + "/" + versionMatch[2];
+ } else {
+ window.location.pathname = "ditto/" + versionValue + "/" + remainingPath;
+ }
+ }
+}
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Signal enrichment</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+
+
+
+<!-- this handles the automatic toc. use ## for subheads to auto-generate the on-page minitoc. if you use html tags, you must supply an ID for the heading element in order for it to appear in the minitoc. -->
+<script>
+$( document ).ready(function() {
+ // Handler for .ready() called.
+
+$('#toc').toc({ minimumHeaders: 0, listType: 'ul', showSpeed: 0, headers: 'h2,h3,h4' });
+
+/* this offset helps account for the space taken up by the floating toolbar. */
+$('#toc').on('click', 'a', function() {
+ var target = $(this.getAttribute('href'))
+ , scroll_target = target.offset().top
+
+ $(window).scrollTop(scroll_target - 10);
+ return false
+})
+
+});
+</script>
+
+<div id="toc"></div>
+
+
+
+
+
+
+
+
+
+ <div class="bs-callout bs-callout-primary">Available since Ditto <strong>1.1.0</strong></div>
+
+<p><a href="basic-signals.html">Signals</a> which are emitted to subscribers via <a href="httpapi-protocol-bindings-websocket.html">WebSocket API</a>,
+<a href="httpapi-sse.html">HTTP SSEs</a> or established <a href="basic-connections.html">connections</a> may be enriched
+by <code class="highlighter-rouge">extraFields</code> to also be included in the sent out messages.</p>
+
+<p><a href="basic-signals-event.html">Events</a>, for example, only contain the actually changed data by default, so when they are
+subscribed to via one of the APIs listed above, the data they contain may be as sparse as:
+“temperature value was changed to 23.4 for thing with ID xx”.</p>
+
+<p>Often it is helpful to additionally include some extra fields as context to be included when subscribing
+(e.g. via WebSocket or a connection). For example in order to include static metadata stored in the <code class="highlighter-rouge">attributes</code>.</p>
+
+<p>Therefore it is possible to define <code class="highlighter-rouge">extraFields</code> to include when subscribing for:</p>
+<ul>
+ <li><a href="basic-changenotifications.html">events/change notifications</a></li>
+ <li><a href="basic-messages.html">messages</a></li>
+ <li><a href="protocol-twinlive.html">live commands</a></li>
+ <li><a href="protocol-twinlive.html">live events</a></li>
+</ul>
+
+<p>How the <code class="highlighter-rouge">extraFields</code> are specified is depending on the API, please find the specific API information here:</p>
+<ul>
+ <li><a href="httpapi-protocol-bindings-websocket.html#enrichment">WebSocket enrichment</a></li>
+ <li><a href="httpapi-sse.html#field-enrichment">SSE field enrichment</a></li>
+ <li><a href="basic-connections.html#target-topics-and-enrichment">Connection target enrichment</a></li>
+</ul>
+
+<p>The <code class="highlighter-rouge">extra</code> data is added to the <a href="protocol-specification.html#extra">extra field in Ditto Protocol messages</a> being an
+JSON object containing all selected fields.</p>
+
+<h2 id="example">Example</h2>
+
+<p>For example a Thing could look like this:</p>
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"thingId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto:fancy-thing"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"policyId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto:fancy-thing"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"attributes"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"location"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Kitchen"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"features"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"temperature"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"properties"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="mf">23.42</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"unit"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Celcius"</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<p>Now whenever its temperature is modified you normally only get the following information in the event
+(this is a <a href="protocol-specification.html">Ditto Protocol</a> message):</p>
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/events/modified"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/features/temperature/properties/value"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="mf">23.42</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"revision"</span><span class="p">:</span><span class="w"> </span><span class="mi">34</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<p>What you could want is to:</p>
+<ul>
+ <li>additionally add the <code class="highlighter-rouge">attributes</code></li>
+ <li>additionally add the <code class="highlighter-rouge">unit</code> value of the temperature</li>
+</ul>
+
+<p>In that case you would define to include <code class="highlighter-rouge">extraFields</code>
+(syntax is the same as for retrieving partial things with <a href="httpapi-concepts.html#with-field-selector">field selector</a>):</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>extraFields=attributes,features/temperature/properties/unit
+</code></pre></div></div>
+
+<p>In that case, each emitted Ditto Protocol event would include an <code class="highlighter-rouge">extra</code> section containing the selected data:</p>
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/events/modified"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/features/temperature/properties/value"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="mf">23.42</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"revision"</span><span class="p">:</span><span class="w"> </span><span class="mi">34</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"extra"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"attributes"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"location"</span><span class="p">:</span><span class="w"> </span><span class="s2">"kitchen"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"features"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"temperature"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"properties"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"unit"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Celcius"</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="enrich-and-filter">Enrich and filter</h2>
+
+<p>In combination with <a href="basic-changenotifications.html#filtering">event filtering</a> enriched data can also be used to
+filter. For example, when selecting <code class="highlighter-rouge">extraFields=attributes/location</code>, an additional <code class="highlighter-rouge">filter</code> may define to only
+emit events for a certain location: <code class="highlighter-rouge">extraFields=attributes/location&filter=eq(attributes/location,"kitchen")</code>.</p>
+
+
+ <div class="tags">
+
+ <b>Tags: </b>
+
+
+
+ <a href="tag_protocol.html" class="btn btn-default navbar-btn cursorNorm" role="button">protocol</a>
+
+
+
+ </div>
+
+</div>
+
+<hr class="shaded"/>
+
+<footer>
+ <div class="row">
+ <div class="col-lg-12 footer">
+ <div class="logo">
+ <a href="https://eclipse.org"><img src="images/eclipse_foundation_logo.svg" alt="Eclipse logo"/></a>
+ </div>
+ <p class="notice">
+ ©2020 Eclipse Ditto.
+ Site last generated: Jul 1, 2020 <br />
+ </p>
+ <div class="quickLinks">
+ <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
+ > Privacy Policy
+ </a>
+ <a href="https://www.eclipse.org/legal/termsofuse.php" target="_blank">
+ > Terms of Use
+ </a>
+ <a href="https://www.eclipse.org/legal/copyright.php" target="_blank">
+ > Copyright Agent
+ </a>
+ <a href="https://www.eclipse.org/legal" target="_blank">
+ > Legal
+ </a>
+ <a href="https://www.eclipse.org/legal/epl-2.0/" target="_blank">
+ > License
+ </a>
+ <a href="https://eclipse.org/security" target="_blank">
+ > Report a Vulnerability
+ </a>
+ </div>
+ </div>
+ </div>
+</footer>
+
+
+ </div>
+ <!-- /.row -->
+</div>
+<!-- /.container -->
+</div>
+<!-- /#main -->
+ </div>
+
+</body>
+</html>
diff --git a/1.0/basic-feature.html b/1.0/basic-feature.html
index d4c6883..e3c99ed 100644
--- a/1.0/basic-feature.html
+++ b/1.0/basic-feature.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1502,7 +1723,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/basic-messages.html b/1.0/basic-messages.html
index a20c9f7..5efab8a 100644
--- a/1.0/basic-messages.html
+++ b/1.0/basic-messages.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1411,7 +1632,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/basic-namespaces-and-names.html b/1.0/basic-namespaces-and-names.html
index 4b94a4e..d3a552f 100644
--- a/1.0/basic-namespaces-and-names.html
+++ b/1.0/basic-namespaces-and-names.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1341,7 +1562,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/basic-overview.html b/1.0/basic-overview.html
index 17feffe..1d56612 100644
--- a/1.0/basic-overview.html
+++ b/1.0/basic-overview.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1260,7 +1481,7 @@
<li><a href="basic-feature.html">Features</a>: intended for managing state data (e.g. sensor data or configuration data) of a <code class="highlighter-rouge">Thing</code>.</li>
</ul>
-<h2 id="api-version-1">API version 1</h2>
+<h2 id="api-version-1---deprecated">API version 1 - Deprecated</h2>
<p>In API version 1 the information which <em>subjects</em> are allowed to READ, WRITE, ADMINISTRATE Things is inlined in the
Things itself. This class diagram shows the structure Ditto requires for <strong>API version 1</strong>:</p>
@@ -1313,6 +1534,41 @@
</span><span class="p">}</span><span class="w">
</span></code></pre></div></div>
+<h3 id="migration-from-api-1-to-api-2">Migration from API 1 to API 2</h3>
+
+<p>In case you need to migrate a thing which was created via API 1 to API 2,
+please note that you need to migrate the access control list entries (ACL) into a <strong>policy</strong>, and to assign your thing to such a policy.</p>
+
+<ol>
+ <li>
+ <p>Request the thing to be migrated, via API 2 and use the field-selector to specify that the inline policy (i.e. <code class="highlighter-rouge">_policy</code>) should also be retrieved.</p>
+
+ <p><code class="highlighter-rouge">GET https://things.eu-1.bosch-iot-suite.com/api/2/things/{$thingId}?fields=_policy</code></p>
+
+ <p><a href="https://www.eclipse.org/ditto/http-api-doc.html#/Things/get_things__thingId_">GET/things/{thingId} Retrieve a specific Thing</a></p>
+ </li>
+ <li>
+ <p>Create a new policy from the content of the requested inline policy, with a <code class="highlighter-rouge">policyId</code> of your choice (e.g. same as the <code class="highlighter-rouge">thingId</code>).</p>
+
+ <p><code class="highlighter-rouge">PUT https://things.eu-1.bosch-iot-suite.com/api/2/policies/{$policyId}</code></p>
+
+ <p><a href="https://www.eclipse.org/ditto/http-api-doc.html#/Policies/put_policies__policyId_">PUT
+ ​/policies​/{policyId}
+ Create or update a Policy with a specified ID</a></p>
+ </li>
+ <li>
+ <p>Assign the new <code class="highlighter-rouge">policyId</code> to the thing to be migrated.</p>
+
+ <p><code class="highlighter-rouge">PUT https://things.eu-1.bosch-iot-suite.com/api/2/things/{$thingId}/policyId</code></p>
+
+ <p><a href="https://www.eclipse.org/ditto/http-api-doc.html#/Things/put_things__thingId__policyId">PUT
+ ​/things​/{thingId}​/policyId
+ Create or update the Policy ID of a Thing</a></p>
+ </li>
+</ol>
+
+<p><strong>Note</strong>: Henceforth the thing cannot be read nor written via API 1. <br />Please make sure all other parts of your application (e.g. device integration, business UI) are using API 2 as well.</p>
+
<h2 id="api-version-2">API version 2</h2>
<p>In API version 2 the information which <em>subjects</em> are allowed to READ, WRITE Things are managed separately via
@@ -1379,7 +1635,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/basic-placeholders.html b/1.0/basic-placeholders.html
index 176bc7f..6ae7488 100644
--- a/1.0/basic-placeholders.html
+++ b/1.0/basic-placeholders.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1534,7 +1755,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/basic-policy.html b/1.0/basic-policy.html
index 741daa4..2648298 100644
--- a/1.0/basic-policy.html
+++ b/1.0/basic-policy.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1680,7 +1901,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/basic-rql.html b/1.0/basic-rql.html
index b6aea52..8017871 100644
--- a/1.0/basic-rql.html
+++ b/1.0/basic-rql.html
@@ -5,7 +5,7 @@
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="description" content="">
-<meta name="keywords" content="rql, rql, query, filter, filtering, search">
+<meta name="keywords" content="rqlprotocol, rql, query, filter, filtering, search">
<title> RQL expressions • Eclipse Ditto • a digital twin framework</title>
<link rel="stylesheet" href="css/syntax.css">
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1451,9 +1672,6 @@
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>not(like(thingId,"org.eclipse.ditto:blacklisted*"))
</code></pre></div></div>
-<div class="alert alert-danger" role="alert"><i class="fa fa-exclamation-circle"></i> <b>Warning:</b> The <code class="highlighter-rouge">not</code> expression is not usable at the <a href="basic-search.html">search</a> API due to
- long running queries against the search index when using negation.</div>
-
<h2 id="rql-sorting">RQL sorting</h2>
<p>The RQL sorting part specifies in which order the result should be returned.</p>
@@ -1505,6 +1723,10 @@
+ <a href="tag_protocol.html" class="btn btn-default navbar-btn cursorNorm" role="button">protocol</a>
+
+
+
</div>
</div>
@@ -1519,7 +1741,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/basic-search.html b/1.0/basic-search.html
index c7a9b57..3c71b0f 100644
--- a/1.0/basic-search.html
+++ b/1.0/basic-search.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li class="active"><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1248,7 +1469,35 @@
- <p>Ditto provides a search functionality as one of the services around its managed <strong>digital twins</strong>.</p>
+ <p>Ditto provides a search functionality as one of the services around its managed <strong>digital twins</strong>.
+The functionality is available for the following APIs.</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>API</th>
+ <th>Access Method</th>
+ <th>Characteristics</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><a href="httpapi-search.html">HTTP</a></td>
+ <td>HTTP request-response</td>
+ <td>Stateless</td>
+ </tr>
+ <tr>
+ <td><a href="protocol-specification-things-search.html">Ditto protocol</a></td>
+ <td><a href="httpapi-protocol-bindings-websocket.html">Websocket</a> and <a href="basic-connections.html">connections</a></td>
+ <td><a href="https://reactive-streams.org">Reactive-streams</a> compatible</td>
+ </tr>
+ <tr>
+ <td><a href="httpapi-sse.html#sse-api-searchthings">Server-sent events</a></td>
+ <td><a href="https://html.spec.whatwg.org/multipage/server-sent-events.html">HTML5 server-sent events</a></td>
+ <td>Streaming with resumption</td>
+ </tr>
+ </tbody>
+</table>
<h2 id="search-index">Search index</h2>
@@ -1264,7 +1513,7 @@
<p>Ditto’s search index provides <strong>eventual consistency</strong>.</p>
<p>In order to reduce load to the database when processing updates in a high frequency, the search index is updated in
-small batches with an default interval of 1 second (configurable via environment variable
+small batches with a default interval of 1 second (configurable via environment variable
<code class="highlighter-rouge">THINGS_SEARCH_UPDATER_STREAM_WRITE_INTERVAL</code>).</p>
<p>That means that when a thing is updated and the API (e.g. the HTTP endpoint) returns a success response, the search index
@@ -1280,7 +1529,7 @@
and return the first 5 results:</p>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Filter: eq(attributes/location,"living-room")
Sorting: sort(+thingId)
-Paging: limit(0,5)
+Paging: size(5),cursor(CURSOR_ID)
</code></pre></div></div>
<h2 id="search-count-queries">Search count queries</h2>
@@ -1298,12 +1547,19 @@
<p>In order to apply queries when searching, Ditto uses the <a href="basic-rql.html">RQL notation</a> which is also applied for other
scenarios (e.g. filtering <a href="basic-changenotifications.html">notifications</a>).</p>
-<h2 id="paging-options">Paging options</h2>
+<h2 id="sorting-and-paging-options">Sorting and paging options</h2>
-<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>size(<count>)
+<p>The <a href="basic-rql.html#rql-sorting"><code class="highlighter-rouge">sort</code> option</a> governs the order of search results.</p>
+
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sort(<+|-><property1>,<+|-><property2>,...)
</code></pre></div></div>
-<p>Limits the search results to <code class="highlighter-rouge"><count></code> items.</p>
+<p>If not given, search results are listed in the ascending order of thing IDs, namely <code class="highlighter-rouge">sort(+thingId)</code>.</p>
+
+<p>The <code class="highlighter-rouge">size</code> option</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>size(<count>)
+</code></pre></div></div>
+<p>limits the search results delivered in one HTTP response or one Ditto protocol message to <code class="highlighter-rouge"><count></code> items.</p>
<p>If the paging option is not explicitly specified a <strong>default value</strong> of <em>25</em> is used. The <strong>maximum</strong> allowed count is
<em>200</em>.</p>
@@ -1322,7 +1578,7 @@
<h2 id="rql-paging-deprecated">RQL paging (deprecated)</h2>
-<div class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> The limit option is deprecated, it may be removed in future releases. Use <a href="basic-search.html#paging-options">cursor-based
+<div class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> The limit option is deprecated, it may be removed in future releases. Use <a href="basic-search.html#sorting-and-paging-options">cursor-based
paging</a> instead.</div>
<p>The RQL limiting part specifies which part (or “page”) should be returned of a large search result set.</p>
@@ -1345,7 +1601,7 @@
</code></pre></div></div>
<p>i.e. Return the next ten items (from index 11 to 20)</p>
-<div class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> We recommend <strong>not to use high offsets</strong> (e.g. higher than 10000) for paging in API 2
+<div class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> We recommend <strong>not to use high offsets</strong> (e.g. higher than 10000) for paging
because of potential performance degradations.</div>
@@ -1378,7 +1634,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/basic-signals-command.html b/1.0/basic-signals-command.html
index 851ebd9..eca4953 100644
--- a/1.0/basic-signals-command.html
+++ b/1.0/basic-signals-command.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1299,7 +1520,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/basic-signals-commandresponse.html b/1.0/basic-signals-commandresponse.html
index c2ac1cb..ff8c898 100644
--- a/1.0/basic-signals-commandresponse.html
+++ b/1.0/basic-signals-commandresponse.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1279,7 +1500,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/basic-signals-errorresponse.html b/1.0/basic-signals-errorresponse.html
index 0456299..0c2a290 100644
--- a/1.0/basic-signals-errorresponse.html
+++ b/1.0/basic-signals-errorresponse.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1281,7 +1502,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/basic-signals-event.html b/1.0/basic-signals-event.html
index c6a1229..046affc 100644
--- a/1.0/basic-signals-event.html
+++ b/1.0/basic-signals-event.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1285,7 +1506,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/basic-signals.html b/1.0/basic-signals.html
index 740cb68..77889b3 100644
--- a/1.0/basic-signals.html
+++ b/1.0/basic-signals.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1250,10 +1471,10 @@
<p>Ditto has a concept called <code class="highlighter-rouge">Signal</code> which combines common functionality of</p>
<ul>
- <li><a href="basic-signals-command.html">Commands,</a></li>
- <li><a href="basic-signals-commandresponse.html">Command Responses,</a></li>
+ <li><a href="basic-signals-command.html">Commands</a>,</li>
+ <li><a href="basic-signals-commandresponse.html">Command Responses</a>,</li>
<li><a href="basic-signals-errorresponse.html">Error Responses</a> and</li>
- <li><a href="basic-signals-event.html">Events.</a></li>
+ <li><a href="basic-signals-event.html">Events</a>.</li>
</ul>
<p>Such common functionality is for example that all those have header fields in which they can be for example correlated
@@ -1329,7 +1550,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/basic-thing.html b/1.0/basic-thing.html
index a719fc9..ae8a245 100644
--- a/1.0/basic-thing.html
+++ b/1.0/basic-thing.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1273,7 +1494,7 @@
<h3 id="access-control">Access control</h3>
<p>A Thing in API version 1 contains an inline <a href="basic-acl.html">ACL</a> defining which authenticated parties may READ, WRITE
-and ADMINISTRATE the <code class="highlighter-rouge">Thing</code>.</p>
+and ADMINISTRATE the <code class="highlighter-rouge">Thing</code>. (Please note that ACL’s are part of deprecated API 1)</p>
<p>A Thing in API version 2 does no longer contain the <a href="#" data-toggle="tooltip" data-original-title="An access control list (ACL) holds the current status on who (subject) is permitted to which extent (read, write, administrate) to manage a Thing.">ACL</a>.
Instead it contains a link to a <a href="basic-policy.html">Policy</a> in form of a <code class="highlighter-rouge">policyId</code>. This
@@ -1301,7 +1522,7 @@
<h3 id="model-specification">Model specification</h3>
-<h4 id="api-version-1">API version 1</h4>
+<h4 id="api-version-1---deprecated">API version 1 - Deprecated</h4>
<script src="docson/widget.js" data-schema="../jsonschema/thing_v1.json"></script>
@@ -1365,7 +1586,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/blog.html b/1.0/blog.html
index a1a9de3..65ba896 100644
--- a/1.0/blog.html
+++ b/1.0/blog.html
@@ -216,6 +216,40 @@
+ <h2><a class="post-link" href="2020-04-29-release-announcement-110.html">Announcing Eclipse Ditto Release 1.1.0</a></h2>
+ <span class="post-meta">Published by <img src="https://www.gravatar.com/avatar/90a82dc2af1620df1f955e211ecc4dee?s=135" alt="A photo of Thomas Jäckle" style="width:25px;border-radius:50%;display:inline-block;margin:0;margin-right:5px;" /><span itemprop="author" itemscope itemtype="http://schema.org/Person"><span itemprop="name"><a href="http://twitter.com/thjaeckle" target="_blank">Thomas Jäckle</a> </span></span> on <time datetime="2020-04-29T00:00:00+00:00" itemprop="datePublished">Apr 29, 2020</time> - Tags:
+
+
+ <a href="tag_blog.html">blog</a>
+
+
+ </span>
+
+ <p> Today, approximately 4 months after Eclipse Ditto’s 1.0.0 release, the team is happy to announce the first minor (feature) update of Ditto 1.0: Eclipse Ditto 1.1.0 The Ditto team was quite busy, 1.1.0 focuses on the following areas: Management of Policies via Ditto Protocol... </p>
+
+
+
+
+
+ <h2><a class="post-link" href="2020-04-16-connecting-to-ttn-via-mqtt.html">Digital twins of devices connected via LoRaWAN to TTN</a></h2>
+ <span class="post-meta">Published by <img src="https://www.gravatar.com/avatar/90a82dc2af1620df1f955e211ecc4dee?s=135" alt="A photo of Thomas Jäckle" style="width:25px;border-radius:50%;display:inline-block;margin:0;margin-right:5px;" /><span itemprop="author" itemscope itemtype="http://schema.org/Person"><span itemprop="name"><a href="http://twitter.com/thjaeckle" target="_blank">Thomas Jäckle</a> </span></span> on <time datetime="2020-04-16T00:00:00+00:00" itemprop="datePublished">Apr 16, 2020</time> - Tags:
+
+
+ <a href="tag_blog.html">blog</a>,
+
+
+
+ <a href="tag_connectivity.html">connectivity</a>
+
+
+ </span>
+
+ <p> A workshop of the 2020 The Things Virtual Conference on April 16th 2020 is/was about how to connect Eclipse Ditto to “The Things Network” via TTN’s MQTT broker in order to automatically update digital twins of devices connected via LoRaWAN... </p>
+
+
+
+
+
<h2><a class="post-link" href="2019-12-12-release-announcement-100.html">Announcing Eclipse Ditto Release 1.0.0</a></h2>
<span class="post-meta">Published by <img src="https://www.gravatar.com/avatar/90a82dc2af1620df1f955e211ecc4dee?s=135" alt="A photo of Thomas Jäckle" style="width:25px;border-radius:50%;display:inline-block;margin:0;margin-right:5px;" /><span itemprop="author" itemscope itemtype="http://schema.org/Person"><span itemprop="name"><a href="http://twitter.com/thjaeckle" target="_blank">Thomas Jäckle</a> </span></span> on <time datetime="2019-12-12T00:00:00+00:00" itemprop="datePublished">Dec 12, 2019</time> - Tags:
@@ -334,36 +368,6 @@
-
-
- <h2><a class="post-link" href="2019-03-13-kafka-connectivity.html">Connectivity to Apache Kafka in Eclipse Ditto</a></h2>
- <span class="post-meta">Published by <img src="https://www.gravatar.com/avatar/90a82dc2af1620df1f955e211ecc4dee?s=135" alt="A photo of Thomas Jäckle" style="width:25px;border-radius:50%;display:inline-block;margin:0;margin-right:5px;" /><span itemprop="author" itemscope itemtype="http://schema.org/Person"><span itemprop="name"><a href="http://twitter.com/thjaeckle" target="_blank">Thomas Jäckle</a> </span></span> on <time datetime="2019-03-13T00:00:00+00:00" itemprop="datePublished">Mar 13, 2019</time> - Tags:
-
-
- <a href="tag_blog.html">blog</a>
-
-
- </span>
-
- <p> Today we added connectivity to Apache Kafka. In a first step, it is possible to publish twin events, messages, live commands and events to Kafka topics. Since the last addition to Ditto’s connectivity which added MQTT connectivity, the connectivity feature got a lot of stabilization and new smaller... </p>
-
-
-
-
-
- <h2><a class="post-link" href="2018-12-05-example-command-and-control.html">Using Eclipse Hono's Command&Control with Eclipse Ditto</a></h2>
- <span class="post-meta">Published by <img src="https://www.gravatar.com/avatar/3b7439f0bd26958055d784ef08bccc21?s=135" alt="A photo of Dominik Guggemos" style="width:25px;border-radius:50%;display:inline-block;margin:0;margin-right:5px;" /><span itemprop="author" itemscope itemtype="http://schema.org/Person"><span itemprop="name"><a href="https://github.com/dguggemos" target="_blank">Dominik Guggemos</a> </span></span> on <time datetime="2018-12-05T00:00:00+00:00" itemprop="datePublished">Dec 5, 2018</time> - Tags:
-
-
- <a href="tag_blog.html">blog</a>
-
-
- </span>
-
- <p> With version 0.8.0 Eclipse Ditto can now interact with Eclipse Hono using the “Command & Control” feature. It is possible to send a Thing (or Feature) message at the Ditto Message API, which is then forwarded to Hono as a command message. Hono routes the message to the device,... </p>
-
-
-
<p><a href="feed.xml" class="btn btn-primary navbar-btn cursorNorm" role="button">RSS Subscribe</a></p>
<hr />
@@ -389,7 +393,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/blog_archive.html b/1.0/blog_archive.html
index d4dcd9b..5bece99 100644
--- a/1.0/blog_archive.html
+++ b/1.0/blog_archive.html
@@ -220,6 +220,24 @@
<ul class="this">
+ <li><time>29 Apr</time><a href="2020-04-29-release-announcement-110.html">Announcing Eclipse Ditto Release 1.1.0</a></li>
+
+
+
+
+
+
+ <li><time>16 Apr</time><a href="2020-04-16-connecting-to-ttn-via-mqtt.html">Digital twins of devices connected via LoRaWAN to TTN</a></li>
+
+
+
+
+
+ </ul>
+ <h3>2019</h3>
+ <ul class="past">
+
+
<li><time>12 Dec</time><a href="2019-12-12-release-announcement-100.html">Announcing Eclipse Ditto Release 1.0.0</a></li>
@@ -428,7 +446,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/client-sdk-java.html b/1.0/client-sdk-java.html
index c2a56e8..fdf72a4 100644
--- a/1.0/client-sdk-java.html
+++ b/1.0/client-sdk-java.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1307,7 +1528,7 @@
<span class="n">MessagingProvider</span> <span class="n">messagingProvider</span> <span class="o">=</span>
<span class="n">MessagingProviders</span><span class="o">.</span><span class="na">webSocket</span><span class="o">(</span><span class="n">WebSocketMessagingConfiguration</span><span class="o">.</span><span class="na">newBuilder</span><span class="o">()</span>
<span class="o">.</span><span class="na">endpoint</span><span class="o">(</span><span class="s">"wss://ditto.eclipse.org"</span><span class="o">)</span>
- <span class="o">.</span><span class="na">jsonSchemaVersion</span><span class="o">(</span><span class="n">JsonSchemaVersion</span><span class="o">.</span><span class="na">V_1</span><span class="o">)</span>
+ <span class="o">.</span><span class="na">jsonSchemaVersion</span><span class="o">(</span><span class="n">JsonSchemaVersion</span><span class="o">.</span><span class="na">V_2</span><span class="o">)</span>
<span class="c1">// optionally configure a proxy server or a truststore containing the trusted CAs for SSL connection establishment</span>
<span class="o">.</span><span class="na">proxyConfiguration</span><span class="o">(</span><span class="n">proxyConfiguration</span><span class="o">)</span>
<span class="o">.</span><span class="na">trustStoreConfiguration</span><span class="o">(</span><span class="n">TrustStoreConfiguration</span><span class="o">.</span><span class="na">newBuilder</span><span class="o">()</span>
@@ -1335,6 +1556,9 @@
<h4 id="subscribe-for-change-notifications">Subscribe for change notifications</h4>
+<p>In order to subscribe for <a href="basic-signals-event.html">events</a> emitted by Ditto after a twin was modified, start the
+consumption on the <code class="highlighter-rouge">twin</code> channel:</p>
+
<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">client</span><span class="o">.</span><span class="na">twin</span><span class="o">().</span><span class="na">startConsumption</span><span class="o">().</span><span class="na">get</span><span class="o">();</span>
<span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span><span class="s">"Subscribed for Twin events"</span><span class="o">);</span>
<span class="n">client</span><span class="o">.</span><span class="na">twin</span><span class="o">().</span><span class="na">registerForThingChanges</span><span class="o">(</span><span class="s">"my-changes"</span><span class="o">,</span> <span class="n">change</span> <span class="o">-></span> <span class="o">{</span>
@@ -1345,6 +1569,42 @@
<span class="o">});</span>
</code></pre></div></div>
+<p>There is also the possibility here to apply <em>server side filtering</em> of which events will get delivered to the client:</p>
+
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">client</span><span class="o">.</span><span class="na">twin</span><span class="o">().</span><span class="na">startConsumption</span><span class="o">(</span>
+ <span class="n">Options</span><span class="o">.</span><span class="na">Consumption</span><span class="o">.</span><span class="na">filter</span><span class="o">(</span><span class="s">"gt(features/temperature/properties/value,23.0)"</span><span class="o">)</span>
+<span class="o">).</span><span class="na">get</span><span class="o">();</span>
+<span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span><span class="s">"Subscribed for Twin events"</span><span class="o">);</span>
+<span class="n">client</span><span class="o">.</span><span class="na">twin</span><span class="o">().</span><span class="na">registerForFeaturePropertyChanges</span><span class="o">(</span><span class="s">"my-feature-changes"</span><span class="o">,</span> <span class="s">"temperature"</span><span class="o">,</span> <span class="s">"value"</span><span class="o">,</span> <span class="n">change</span> <span class="o">-></span> <span class="o">{</span>
+ <span class="c1">// perform custom actions ..</span>
+<span class="o">});</span>
+</code></pre></div></div>
+
+<h5 id="subscribe-to-enriched-change-notifications">Subscribe to enriched change notifications</h5>
+
+<div class="bs-callout bs-callout-primary">Available since Ditto <strong>1.1.0</strong></div>
+
+<p>In order to use <a href="basic-enrichment.html">enrichment</a> in the Ditto Java client, the <code class="highlighter-rouge">startConsumption()</code> call can be
+enhanced with the additional extra fields:</p>
+
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">client</span><span class="o">.</span><span class="na">twin</span><span class="o">().</span><span class="na">startConsumption</span><span class="o">(</span>
+ <span class="n">Options</span><span class="o">.</span><span class="na">Consumption</span><span class="o">.</span><span class="na">extraFields</span><span class="o">(</span><span class="n">JsonFieldSelector</span><span class="o">.</span><span class="na">newInstance</span><span class="o">(</span><span class="s">"attributes/location"</span><span class="o">))</span>
+<span class="o">).</span><span class="na">get</span><span class="o">();</span>
+<span class="n">client</span><span class="o">.</span><span class="na">twin</span><span class="o">().</span><span class="na">registerForThingChanges</span><span class="o">(</span><span class="s">"my-enriched-changes"</span><span class="o">,</span> <span class="n">change</span> <span class="o">-></span> <span class="o">{</span>
+ <span class="n">Optional</span><span class="o"><</span><span class="n">JsonObject</span><span class="o">></span> <span class="n">extra</span> <span class="o">=</span> <span class="n">change</span><span class="o">.</span><span class="na">getExtra</span><span class="o">();</span>
+ <span class="c1">// perform custom actions, making use of the 'extra' data ..</span>
+<span class="o">});</span>
+</code></pre></div></div>
+
+<p>In combination with a <code class="highlighter-rouge">filter</code>, the extra fields may also be used as part of such a filter:</p>
+
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">client</span><span class="o">.</span><span class="na">twin</span><span class="o">().</span><span class="na">startConsumption</span><span class="o">(</span>
+ <span class="n">Options</span><span class="o">.</span><span class="na">Consumption</span><span class="o">.</span><span class="na">extraFields</span><span class="o">(</span><span class="n">JsonFieldSelector</span><span class="o">.</span><span class="na">newInstance</span><span class="o">(</span><span class="s">"attributes/location"</span><span class="o">)),</span>
+ <span class="n">Options</span><span class="o">.</span><span class="na">Consumption</span><span class="o">.</span><span class="na">filter</span><span class="o">(</span><span class="s">"eq(attributes/location,\"kitchen\")"</span><span class="o">)</span>
+<span class="o">).</span><span class="na">get</span><span class="o">();</span>
+<span class="c1">// register the callbacks...</span>
+</code></pre></div></div>
+
<h4 id="sendreceive-messages">Send/receive messages</h4>
<p>Register for receiving messages with the subject <code class="highlighter-rouge">hello.world</code> on any thing:</p>
@@ -1370,7 +1630,95 @@
<span class="o">);</span>
</code></pre></div></div>
-<h2 id="further-examples">Further Examples</h2>
+<h4 id="manage-policies">Manage policies</h4>
+
+<div class="bs-callout bs-callout-primary">Available since Ditto <strong>1.1.0</strong></div>
+
+<p>Read a policy:</p>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">Policy</span> <span class="n">retrievedPolicy</span> <span class="o">=</span> <span class="n">client</span><span class="o">.</span><span class="na">policies</span><span class="o">().</span><span class="na">retrieve</span><span class="o">(</span><span class="n">PolicyId</span><span class="o">.</span><span class="na">of</span><span class="o">(</span><span class="s">"org.eclipse.ditto:new-policy"</span><span class="o">))</span>
+ <span class="o">.</span><span class="na">get</span><span class="o">();</span> <span class="c1">// this will block the thread! work asynchronously whenever possible!</span>
+</code></pre></div></div>
+
+<p>Create a policy:</p>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">Policy</span> <span class="n">newPolicy</span> <span class="o">=</span> <span class="n">Policy</span><span class="o">.</span><span class="na">newBuilder</span><span class="o">(</span><span class="n">PolicyId</span><span class="o">.</span><span class="na">of</span><span class="o">(</span><span class="s">"org.eclipse.ditto:new-policy"</span><span class="o">))</span>
+ <span class="o">.</span><span class="na">forLabel</span><span class="o">(</span><span class="s">"DEFAULT"</span><span class="o">)</span>
+ <span class="o">.</span><span class="na">setSubject</span><span class="o">(</span><span class="n">Subject</span><span class="o">.</span><span class="na">newInstance</span><span class="o">(</span><span class="n">SubjectIssuer</span><span class="o">.</span><span class="na">newInstance</span><span class="o">(</span><span class="s">"nginx"</span><span class="o">),</span> <span class="s">"ditto"</span><span class="o">))</span>
+ <span class="o">.</span><span class="na">setGrantedPermissions</span><span class="o">(</span><span class="n">PoliciesResourceType</span><span class="o">.</span><span class="na">policyResource</span><span class="o">(</span><span class="s">"/"</span><span class="o">),</span> <span class="s">"READ"</span><span class="o">,</span> <span class="s">"WRITE"</span><span class="o">)</span>
+ <span class="o">.</span><span class="na">setGrantedPermissions</span><span class="o">(</span><span class="n">PoliciesResourceType</span><span class="o">.</span><span class="na">thingResource</span><span class="o">(</span><span class="s">"/"</span><span class="o">),</span> <span class="s">"READ"</span><span class="o">,</span> <span class="s">"WRITE"</span><span class="o">)</span>
+ <span class="o">.</span><span class="na">build</span><span class="o">();</span>
+
+<span class="n">client</span><span class="o">.</span><span class="na">policies</span><span class="o">().</span><span class="na">create</span><span class="o">(</span><span class="n">newPolicy</span><span class="o">)</span>
+ <span class="o">.</span><span class="na">get</span><span class="o">();</span> <span class="c1">// this will block the thread! work asynchronously whenever possible!</span>
+</code></pre></div></div>
+
+<p>Updating and deleting policies is also possible via the Java client API, please follow the API and the JavaDoc.</p>
+
+<h4 id="search-for-things">Search for things</h4>
+
+<div class="bs-callout bs-callout-primary">Available since Ditto <strong>1.1.0</strong></div>
+
+<p>Search for things using the Java 8 <code class="highlighter-rouge">java.util.Stream</code> API:</p>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">client</span><span class="o">.</span><span class="na">twin</span><span class="o">().</span><span class="na">search</span><span class="o">()</span>
+ <span class="o">.</span><span class="na">stream</span><span class="o">(</span><span class="n">queryBuilder</span> <span class="o">-></span> <span class="n">queryBuilder</span><span class="o">.</span><span class="na">namespace</span><span class="o">(</span><span class="s">"org.eclipse.ditto"</span><span class="o">)</span>
+ <span class="o">.</span><span class="na">filter</span><span class="o">(</span><span class="s">"eq(attributes/location,'kitchen')"</span><span class="o">)</span> <span class="c1">// apply RQL expression here</span>
+ <span class="o">.</span><span class="na">options</span><span class="o">(</span><span class="n">builder</span> <span class="o">-></span> <span class="n">builder</span><span class="o">.</span><span class="na">sort</span><span class="o">(</span><span class="n">s</span> <span class="o">-></span> <span class="n">s</span><span class="o">.</span><span class="na">desc</span><span class="o">(</span><span class="s">"thingId"</span><span class="o">)).</span><span class="na">size</span><span class="o">(</span><span class="mi">1</span><span class="o">))</span>
+ <span class="o">)</span>
+ <span class="o">.</span><span class="na">forEach</span><span class="o">(</span><span class="n">foundThing</span> <span class="o">-></span> <span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span><span class="s">"Found thing: "</span> <span class="o">+</span> <span class="n">foundThing</span><span class="o">));</span>
+</code></pre></div></div>
+
+<p>Use an <a href="basic-rql.html">RQL</a> query in order to filter for the searched things.</p>
+
+<p>Search for things using the reactive streams <code class="highlighter-rouge">org.reactivestreams.Publisher</code> API:</p>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">Publisher</span><span class="o"><</span><span class="n">List</span><span class="o"><</span><span class="n">Thing</span><span class="o">>></span> <span class="n">publisher</span> <span class="o">=</span> <span class="n">client</span><span class="o">.</span><span class="na">twin</span><span class="o">().</span><span class="na">search</span><span class="o">()</span>
+ <span class="o">.</span><span class="na">publisher</span><span class="o">(</span><span class="n">queryBuilder</span> <span class="o">-></span> <span class="n">queryBuilder</span><span class="o">.</span><span class="na">namespace</span><span class="o">(</span><span class="s">"org.eclipse.ditto"</span><span class="o">)</span>
+ <span class="o">.</span><span class="na">filter</span><span class="o">(</span><span class="s">"eq(attributes/location,'kitchen')"</span><span class="o">)</span> <span class="c1">// apply RQL expression here</span>
+ <span class="o">.</span><span class="na">options</span><span class="o">(</span><span class="n">builder</span> <span class="o">-></span> <span class="n">builder</span><span class="o">.</span><span class="na">sort</span><span class="o">(</span><span class="n">s</span> <span class="o">-></span> <span class="n">s</span><span class="o">.</span><span class="na">desc</span><span class="o">(</span><span class="s">"thingId"</span><span class="o">)).</span><span class="na">size</span><span class="o">(</span><span class="mi">1</span><span class="o">))</span>
+ <span class="o">);</span>
+<span class="c1">// integrate the publisher in the reactive streams library of your choice, e.g. Akka streams:</span>
+<span class="n">akka</span><span class="o">.</span><span class="na">stream</span><span class="o">.</span><span class="na">javadsl</span><span class="o">.</span><span class="na">Source</span><span class="o"><</span><span class="n">Thing</span><span class="o">,</span> <span class="n">NotUsed</span><span class="o">></span> <span class="n">things</span> <span class="o">=</span> <span class="n">akka</span><span class="o">.</span><span class="na">stream</span><span class="o">.</span><span class="na">javadsl</span><span class="o">.</span><span class="na">Source</span><span class="o">.</span><span class="na">fromPublisher</span><span class="o">(</span><span class="n">publisher</span><span class="o">)</span>
+ <span class="o">.</span><span class="na">flatMapConcat</span><span class="o">(</span><span class="nl">Source:</span><span class="o">:</span><span class="n">from</span><span class="o">);</span>
+<span class="c1">// .. proceed working with the Akka Source ..</span>
+</code></pre></div></div>
+
+<h4 id="request-and-issue-acknowledgements">Request and issue acknowledgements</h4>
+
+<div class="bs-callout bs-callout-primary">Available since Ditto <strong>1.1.0</strong></div>
+
+<p><a href="basic-acknowledgements.html#requesting-acknowledgements">Requesting acknowledgements</a> is possible in the Ditto Java
+client in the following way:</p>
+
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">DittoHeaders</span> <span class="n">dittoHeaders</span> <span class="o">=</span> <span class="n">DittoHeaders</span><span class="o">.</span><span class="na">newBuilder</span><span class="o">()</span>
+ <span class="o">.</span><span class="na">acknowledgementRequest</span><span class="o">(</span>
+ <span class="n">AcknowledgementRequest</span><span class="o">.</span><span class="na">of</span><span class="o">(</span><span class="n">DittoAcknowledgementLabel</span><span class="o">.</span><span class="na">PERSISTED</span><span class="o">),</span>
+ <span class="n">AcknowledgementRequest</span><span class="o">.</span><span class="na">of</span><span class="o">(</span><span class="n">AcknowledgementLabel</span><span class="o">.</span><span class="na">of</span><span class="o">(</span><span class="s">"my-custom-ack"</span><span class="o">))</span>
+ <span class="o">)</span>
+ <span class="o">.</span><span class="na">timeout</span><span class="o">(</span><span class="s">"5s"</span><span class="o">)</span>
+ <span class="o">.</span><span class="na">build</span><span class="o">();</span>
+
+<span class="n">client</span><span class="o">.</span><span class="na">twin</span><span class="o">().</span><span class="na">forId</span><span class="o">(</span><span class="n">ThingId</span><span class="o">.</span><span class="na">of</span><span class="o">(</span><span class="s">"org.eclipse.ditto:my-thing"</span><span class="o">))</span>
+ <span class="o">.</span><span class="na">putAttribute</span><span class="o">(</span><span class="s">"counter"</span><span class="o">,</span> <span class="mi">42</span><span class="o">,</span> <span class="n">Options</span><span class="o">.</span><span class="na">dittoHeaders</span><span class="o">(</span><span class="n">dittoHeaders</span><span class="o">))</span>
+ <span class="o">.</span><span class="na">whenComplete</span><span class="o">((</span><span class="n">aVoid</span><span class="o">,</span> <span class="n">throwable</span><span class="o">)</span> <span class="o">-></span> <span class="o">{</span>
+ <span class="k">if</span> <span class="o">(</span><span class="n">throwable</span> <span class="k">instanceof</span> <span class="n">AcknowledgementsFailedException</span><span class="o">)</span> <span class="o">{</span>
+ <span class="n">Acknowledgements</span> <span class="n">acknowledgements</span> <span class="o">=</span> <span class="o">((</span><span class="n">AcknowledgementsFailedException</span><span class="o">)</span> <span class="n">throwable</span><span class="o">).</span><span class="na">getAcknowledgements</span><span class="o">();</span>
+ <span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span><span class="s">"Acknowledgements could not be fulfilled: "</span> <span class="o">+</span> <span class="n">acknowledgements</span><span class="o">);</span>
+ <span class="o">}</span>
+ <span class="o">});</span>
+</code></pre></div></div>
+
+<p><a href="basic-acknowledgements.html#issuing-acknowledgements">Issuing requested acknowledgements</a> can be done like this
+whenever a <code class="highlighter-rouge">Change</code> callback is invoked with a change notification:</p>
+
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">client</span><span class="o">.</span><span class="na">twin</span><span class="o">().</span><span class="na">registerForThingChanges</span><span class="o">(</span><span class="s">"REG1"</span><span class="o">,</span> <span class="n">change</span> <span class="o">-></span> <span class="o">{</span>
+ <span class="n">change</span><span class="o">.</span><span class="na">handleAcknowledgementRequest</span><span class="o">(</span><span class="n">AcknowledgementLabel</span><span class="o">.</span><span class="na">of</span><span class="o">(</span><span class="s">"my-custom-ack"</span><span class="o">),</span> <span class="n">ackHandle</span> <span class="o">-></span>
+ <span class="n">ackHandle</span><span class="o">.</span><span class="na">acknowledge</span><span class="o">(</span><span class="n">HttpStatusCode</span><span class="o">.</span><span class="na">NOT_FOUND</span><span class="o">,</span> <span class="n">JsonObject</span><span class="o">.</span><span class="na">newBuilder</span><span class="o">()</span>
+ <span class="o">.</span><span class="na">set</span><span class="o">(</span><span class="s">"error-detail"</span><span class="o">,</span> <span class="s">"Could not be found"</span><span class="o">)</span>
+ <span class="o">.</span><span class="na">build</span><span class="o">()</span>
+ <span class="o">)</span>
+ <span class="o">);</span>
+<span class="o">});</span>
+</code></pre></div></div>
+
+<h2 id="further-examples">Further examples</h2>
<p>For further examples on how to use the Ditto client, please have a look at the class
<a href="https://github.com/eclipse/ditto-clients/blob/master/java/src/test/java/org/eclipse/ditto/client/DittoClientUsageExamples.java">DittoClientUsageExamples</a>
@@ -1399,7 +1747,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/client-sdk-javascript.html b/1.0/client-sdk-javascript.html
index edaa633..ee68892 100644
--- a/1.0/client-sdk-javascript.html
+++ b/1.0/client-sdk-javascript.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1335,7 +1556,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/client-sdk-overview.html b/1.0/client-sdk-overview.html
index 84f729d..059d8dd 100644
--- a/1.0/client-sdk-overview.html
+++ b/1.0/client-sdk-overview.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1282,7 +1503,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/connectivity-header-mapping.html b/1.0/connectivity-header-mapping.html
index 0d3a92a..8161fe7 100644
--- a/1.0/connectivity-header-mapping.html
+++ b/1.0/connectivity-header-mapping.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1292,7 +1513,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/connectivity-manage-connections.html b/1.0/connectivity-manage-connections.html
index 75e642f..2075355 100644
--- a/1.0/connectivity-manage-connections.html
+++ b/1.0/connectivity-manage-connections.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1257,6 +1478,12 @@
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>POST /devops/piggyback/connectivity
</code></pre></div></div>
+<h2 id="authorization">Authorization</h2>
+
+<p>When creating new connections, an <code class="highlighter-rouge">authorizationContext</code> is needed providing the <em>authorization subjects</em> (e.g. IDs of authorized users) to use in order to determine the permissions for when the connection executes commands (e.g. modifying a Thing).
+If you want to use a user for the basic auth (from the <a href="connectivity-protocol-bindings-http.html">HTTP API</a>) use the prefix <code class="highlighter-rouge">nginx:</code>, e.g. <code class="highlighter-rouge">nginx:ditto</code>.
+See <a href="basic-auth.html#authorization-context-in-devops-commands">Basic Authentication</a> for more information.</p>
+
<h2 id="crud-commands">CRUD commands</h2>
<p>The following commands are available in order to manage connections:</p>
@@ -1591,7 +1818,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/connectivity-mapping.html b/1.0/connectivity-mapping.html
index 7f89337..647b5f4 100644
--- a/1.0/connectivity-mapping.html
+++ b/1.0/connectivity-mapping.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1534,11 +1755,12 @@
* @param {Object.<string, string>} dittoHeaders - The headers Object containing all Ditto Protocol header values
* @param {*} [value] - The value to apply / which was applied (e.g. in a "modify" action)
* @param {number} status - The status code that indicates the result of the command.
+ * @param {Object} extra - The enriched extra fields when selected via "extraFields" option.
* @returns {DittoProtocolMessage} dittoProtocolMessage -
* the mapped Ditto Protocol message or
* <code>null</code> if the message could/should not be mapped
*/</span>
-<span class="kd">function</span> <span class="nx">buildDittoProtocolMsg</span><span class="p">(</span><span class="nx">namespace</span><span class="p">,</span> <span class="nx">id</span><span class="p">,</span> <span class="nx">group</span><span class="p">,</span> <span class="nx">channel</span><span class="p">,</span> <span class="nx">criterion</span><span class="p">,</span> <span class="nx">action</span><span class="p">,</span> <span class="nx">path</span><span class="p">,</span> <span class="nx">dittoHeaders</span><span class="p">,</span> <span class="nx">value</span><span class="p">,</span> <span class="nx">status</span><span class="p">)</span> <span class="p">{</span>
+<span class="kd">function</span> <span class="nx">buildDittoProtocolMsg</span><span class="p">(</span><span class="nx">namespace</span><span class="p">,</span> <span class="nx">id</span><span class="p">,</span> <span class="nx">group</span><span class="p">,</span> <span class="nx">channel</span><span class="p">,</span> <span class="nx">criterion</span><span class="p">,</span> <span class="nx">action</span><span class="p">,</span> <span class="nx">path</span><span class="p">,</span> <span class="nx">dittoHeaders</span><span class="p">,</span> <span class="nx">value</span><span class="p">,</span> <span class="nx">status</span><span class="p">,</span> <span class="nx">extra</span><span class="p">)</span> <span class="p">{</span>
<span class="kd">let</span> <span class="nx">dittoProtocolMsg</span> <span class="o">=</span> <span class="p">{};</span>
<span class="nx">dittoProtocolMsg</span><span class="p">.</span><span class="nx">topic</span> <span class="o">=</span> <span class="nx">namespace</span> <span class="o">+</span> <span class="s2">"/"</span> <span class="o">+</span> <span class="nx">id</span> <span class="o">+</span> <span class="s2">"/"</span> <span class="o">+</span> <span class="nx">group</span> <span class="o">+</span> <span class="s2">"/"</span> <span class="o">+</span> <span class="nx">channel</span> <span class="o">+</span> <span class="s2">"/"</span> <span class="o">+</span> <span class="nx">criterion</span> <span class="o">+</span> <span class="s2">"/"</span> <span class="o">+</span> <span class="nx">action</span><span class="p">;</span>
@@ -1546,6 +1768,7 @@
<span class="nx">dittoProtocolMsg</span><span class="p">.</span><span class="nx">headers</span> <span class="o">=</span> <span class="nx">dittoHeaders</span><span class="p">;</span>
<span class="nx">dittoProtocolMsg</span><span class="p">.</span><span class="nx">value</span> <span class="o">=</span> <span class="nx">value</span><span class="p">;</span>
<span class="nx">dittoProtocolMsg</span><span class="p">.</span><span class="nx">status</span> <span class="o">=</span> <span class="nx">status</span><span class="p">;</span>
+ <span class="nx">dittoProtocolMsg</span><span class="p">.</span><span class="nx">extra</span> <span class="o">=</span> <span class="nx">extra</span><span class="p">;</span>
<span class="k">return</span> <span class="nx">dittoProtocolMsg</span><span class="p">;</span>
<span class="p">}</span>
@@ -1673,6 +1896,7 @@
* @param {Object.<string, string>} dittoHeaders - The headers Object containing all Ditto Protocol header values
* @param {*} [value] - The value to apply / which was applied (e.g. in a "modify" action)
* @param {number} status - The status code that indicates the result of the command.
+ * @param {Object} extra - The enriched extra fields when selected via "extraFields" option.
* @returns {(ExternalMessage|Array<ExternalMessage>)} externalMessage -
* The mapped external message,
* an array of external messages or
@@ -1688,7 +1912,8 @@
<span class="nx">path</span><span class="p">,</span>
<span class="nx">dittoHeaders</span><span class="p">,</span>
<span class="nx">value</span><span class="p">,</span>
- <span class="nx">status</span>
+ <span class="nx">status</span><span class="p">,</span>
+ <span class="nx">extra</span>
<span class="p">)</span> <span class="p">{</span>
<span class="c1">// ###</span>
@@ -2058,7 +2283,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/connectivity-overview.html b/1.0/connectivity-overview.html
index c204677..b35c064 100644
--- a/1.0/connectivity-overview.html
+++ b/1.0/connectivity-overview.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1293,7 +1514,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/connectivity-protocol-bindings-amqp091.html b/1.0/connectivity-protocol-bindings-amqp091.html
index 251bc58..fcc5693 100644
--- a/1.0/connectivity-protocol-bindings-amqp091.html
+++ b/1.0/connectivity-protocol-bindings-amqp091.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1391,7 +1612,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/connectivity-protocol-bindings-amqp10.html b/1.0/connectivity-protocol-bindings-amqp10.html
index 4c9831e..cd672f7 100644
--- a/1.0/connectivity-protocol-bindings-amqp10.html
+++ b/1.0/connectivity-protocol-bindings-amqp10.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1437,7 +1658,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/connectivity-protocol-bindings-http.html b/1.0/connectivity-protocol-bindings-http.html
index 6c93867..852a712 100644
--- a/1.0/connectivity-protocol-bindings-http.html
+++ b/1.0/connectivity-protocol-bindings-http.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li class="active"><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1382,7 +1603,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/connectivity-protocol-bindings-kafka2.html b/1.0/connectivity-protocol-bindings-kafka2.html
index 78e979a..a239ddf 100644
--- a/1.0/connectivity-protocol-bindings-kafka2.html
+++ b/1.0/connectivity-protocol-bindings-kafka2.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1381,7 +1602,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/connectivity-protocol-bindings-mqtt.html b/1.0/connectivity-protocol-bindings-mqtt.html
index d208f95..9f11df7 100644
--- a/1.0/connectivity-protocol-bindings-mqtt.html
+++ b/1.0/connectivity-protocol-bindings-mqtt.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1303,6 +1524,10 @@
</span><span class="p">}</span><span class="w">
</span></code></pre></div></div>
+<p>Note: This example assumes that there is a valid user named <code class="highlighter-rouge">ditto:inbound-auth-subject</code> in Ditto.
+If you want to use a user for the basic auth (from the <a href="connectivity-protocol-bindings-http.html">HTTP API</a>) use the prefix <code class="highlighter-rouge">nginx:</code>, e.g. <code class="highlighter-rouge">nginx:ditto</code>.
+See <a href="basic-auth.html#authorization-context-in-devops-commands">Basic Authentication</a> for more information.</p>
+
<h4 id="enforcement">Enforcement</h4>
<p>As MQTT 3.1.1 does not support headers in its protocol, headers may not be used during <a href="basic-connections.html#source-enforcement">source enforcement</a>.</p>
@@ -1343,6 +1568,30 @@
<p>As MQTT 3.1.1 does not support headers in its protocol, a <a href="connectivity-header-mapping.html">header mapping</a> is not possible to configure here.</p>
+<h3 id="specific-config">Specific Config</h3>
+
+<p>The MQTT binding offers an additional <a href="basic-connections.html#specific-config">specific configuration</a> for the mqtt client id. If the
+<code class="highlighter-rouge">clientId</code> is not configured as a <a href="basic-connections.html#specific-config">specific config</a> Ditto will use the <code class="highlighter-rouge">connection-id</code> as <code class="highlighter-rouge">clientId</code>
+for the outgoing mqtt connection.</p>
+
+<p>Example</p>
+
+<p>Defining the client id <code class="highlighter-rouge">my-awesome-mqtt-client-id</code>:</p>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"mqtt-example-connection-123"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"connectionType"</span><span class="p">:</span><span class="w"> </span><span class="s2">"mqtt"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"connectionStatus"</span><span class="p">:</span><span class="w"> </span><span class="s2">"open"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"failoverEnabled"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"uri"</span><span class="p">:</span><span class="w"> </span><span class="s2">"tcp://test.mosquitto.org:1883"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"specificConfig"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"clientId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"my-awesome-mqtt-client-id"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"sources"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">"..."</span><span class="p">],</span><span class="w">
+ </span><span class="s2">"targets"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">"..."</span><span class="p">]</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
<h2 id="establishing-a-connection-to-an-mqtt-311-endpoint">Establishing a connection to an MQTT 3.1.1 endpoint</h2>
<p>Ditto’s <a href="architecture-services-connectivity.html">Connectivity service</a> is responsible for creating new and managing
@@ -1458,7 +1707,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/connectivity-protocol-bindings-mqtt5.html b/1.0/connectivity-protocol-bindings-mqtt5.html
new file mode 100644
index 0000000..263745d
--- /dev/null
+++ b/1.0/connectivity-protocol-bindings-mqtt5.html
@@ -0,0 +1,1714 @@
+<!DOCTYPE html>
+<html>
+<head>
+ <meta charset="utf-8">
+<meta http-equiv="X-UA-Compatible" content="IE=edge">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="description" content="">
+<meta name="keywords" content="protocolconnectivity, binding, protocol, mqtt, mqtt5">
+<title> MQTT 5 protocol binding • Eclipse Ditto • a digital twin framework</title>
+
+<link rel="stylesheet" href="css/syntax.css">
+<link rel="stylesheet" type="text/css" href="//cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/modern-business.css">
+<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/customstyles.css">
+<link rel="stylesheet" href="css/boxshadowproperties.css">
+<link rel="stylesheet" href="css/theme-ditto.css">
+<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:400,700|Source+Code+Pro:300,600|Titillium+Web:400,600,700">
+
+<script src="//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.4/jquery.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/js/bootstrap.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/anchor-js/2.0.0/anchor.min.js" crossorigin="anonymous"></script>
+<script src="js/toc.js"></script>
+<script src="js/customscripts.js"></script>
+
+<script type="application/ld+json">
+{
+ "@context": "http://schema.org",
+ "@type": "Organization",
+ "url": "https://eclipse.org/ditto/",
+ "logo": "https://eclipse.org/ditto/images/ditto.svg"
+}
+</script>
+
+<link rel="icon" type="image/png" href="images/favicon-16x16.png" sizes="16x16">
+<link rel="icon" type="image/png" href="images/favicon-32x32.png" sizes="32x32">
+<link rel="icon" type="image/png" href="images/favicon-96x96.png" sizes="96x96">
+
+<link rel="alternate" type="application/rss+xml" title="Eclipse Ditto Blog" href="https://www.eclipse.org/ditto/feed.xml">
+
+<!-- Eclipse Foundation cookie consent: -->
+<link rel="stylesheet" type="text/css" href="//www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css" />
+<script src="//www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+ <script>
+ $(document).ready(function() {
+ $("#tg-sb-link").click(function() {
+ $("#tg-sb-sidebar").toggle();
+ $("#tg-sb-content").toggleClass('col-md-9');
+ $("#tg-sb-content").toggleClass('col-md-12');
+ $("#tg-sb-icon").toggleClass('fa-toggle-on');
+ $("#tg-sb-icon").toggleClass('fa-toggle-off');
+ });
+ });
+ </script>
+</head>
+
+
+<script>
+ (function(w,d,s,l,i){
+ w[l]=w[l]||[];
+ w[l].push({'gtm.start':
+ new Date().getTime(),event:'gtm.js'});
+ var f=d.getElementsByTagName(s)[0],
+ j=d.createElement(s),
+ dl=l!='dataLayer'?'&l='+l:'';
+ j.async=true;
+ j.src='https://www.googletagmanager.com/gtm.js?id='+i+dl;
+ f.parentNode.insertBefore(j,f);
+ })(window,document,'script','dataLayer','GTM-5WLCZXC');
+</script>
+
+
+
+<body>
+<!-- Navigation -->
+<nav class="navbar navbar-inverse navbar-fixed-top">
+ <div class="container topnavlinks">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-ditto-home" href="index.html"> <img src="images/ditto_allwhite_symbolonly.svg" class="ditto-navbar-symbol" alt="Home"> <img src="images/ditto_allwhite_textonly.svg" class="ditto-navbar-symbol-text" alt="Ditto"></a>
+ </div>
+ <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
+ <ul class="nav navbar-nav navbar-right">
+ <!-- toggle sidebar button -->
+ <!--<li><a id="tg-sb-link" href="#"><i id="tg-sb-icon" class="fa fa-toggle-on"></i> Nav</a></li>-->
+ <!-- entries without drop-downs appear here -->
+
+
+
+
+
+
+
+ <li><a href="blog.html">Blog</a></li>
+
+
+
+ <li><a href="intro-overview.html">Documentation</a></li>
+
+
+
+ <li><a href="http-api-doc.html">HTTP API</a></li>
+
+
+
+ <li><a href="https://ditto.eclipse.org" target="_blank">Sandbox</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">GitHub</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">GitHub examples</a></li>
+
+
+
+ <!-- entries with drop-downs appear here -->
+ <!-- conditional logic to control which topnav appears for the audience defined in the configuration file.-->
+
+
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Links<b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+
+ <li><a href="https://projects.eclipse.org/projects/iot.ditto" target="_blank">Eclipse Ditto Project</a></li>
+
+
+
+ <li><a href="https://www.eclipse.org/forums/index.php/f/364/" target="_blank">Forum</a></li>
+
+
+
+ <li><a href="https://ci.eclipse.org/ditto/" target="_blank">Jenkins</a></li>
+
+
+
+ <li><a href="https://dev.eclipse.org/mhonarc/lists/ditto-dev/" target="_blank">Mailing list archives</a></li>
+
+
+
+ <li><a href="https://gitter.im/eclipse/ditto" target="_blank">Gitter.im chat</a></li>
+
+
+ </ul>
+ </li>
+
+
+
+ <!--comment out this block if you want to hide search-->
+ <li>
+ <!--start search-->
+ <div id="search-demo-container">
+ <input type="text" id="search-input" placeholder="search...">
+ <ul id="results-container"></ul>
+ </div>
+ <script src="//cdnjs.cloudflare.com/ajax/libs/simple-jekyll-search/0.0.9/jekyll-search.js" type="text/javascript"></script>
+ <script type="text/javascript">
+ SimpleJekyllSearch.init({
+ searchInput: document.getElementById('search-input'),
+ resultsContainer: document.getElementById('results-container'),
+ dataSource: 'search.json',
+ searchResultTemplate: '<li><a href="{url}" title="MQTT 5 protocol binding">{title}</a></li>',
+ noResultsText: 'No results found.',
+ limit: 10,
+ fuzzy: true,
+ })
+ </script>
+ <!--end search-->
+ </li>
+ </ul>
+ </div>
+ </div>
+ <!-- /.container -->
+</nav>
+
+<!-- Page Content -->
+<div class="container">
+ <div id="main">
+ <!-- Content Row -->
+ <div class="row">
+
+
+ <!-- Sidebar Column -->
+ <div class="col-md-3" id="tg-sb-sidebar">
+
+
+<ul id="mysidebar" class="nav">
+ <li class="sidebarTitle">
+ <label for="docVersion">Eclipse Ditto version:</label>
+ <div class="select-wrapper">
+ <select id="docVersion" name="docVersion">
+
+ <option value="">development</option>
+
+ <option value="1.0">1.0</option>
+
+ <option value="1.1">1.1</option>
+
+ </select>
+ </div>
+ <div id="dev-warning">
+ <div markdown="span" class="alert alert-warning" role="alert" style="font-size:0.6em"><i class="fa fa-warning"></i> <b>Important:</b> This documentation reflects the latest 'development'. You might want to choose a released version.</div>
+ </div>
+ </li>
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Introduction</a>
+ <ul>
+
+
+
+ <li><a href="intro-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="intro-digitaltwins.html">Digital twins</a></li>
+
+
+
+
+
+
+ <li><a href="intro-hello-world.html">Hello world</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Release Notes</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_100.html">1.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_090.html">0.9.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_080.html">0.8.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Milestone releases</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_100-M2.html">1.0.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_100-M1a.html">1.0.0-M1a</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M2.html">0.9.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M1.html">0.9.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M3.html">0.8.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M2.html">0.8.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M1.html">0.8.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M2.html">0.3.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M1.html">0.3.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_020-M1.html">0.2.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M3.html">0.1.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M1.html">0.1.0-M1</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Installation</a>
+ <ul>
+
+
+
+ <li><a href="installation-building.html">Building Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-running.html">Running Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-operating.html">Operating Ditto</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Basic concepts</a>
+ <ul>
+
+
+
+ <li><a href="basic-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Model entities</a>
+ <ul>
+
+
+
+ <li><a href="basic-thing.html">Thing</a></li>
+
+
+
+
+
+ <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
+
+
+
+
+
+ <li><a href="basic-feature.html">Feature</a></li>
+
+
+
+
+
+ <li><a href="basic-policy.html">Policy</a></li>
+
+
+
+
+
+ <li><a href="basic-namespaces-and-names.html">Namespaces and Names</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-auth.html">Authentication and Authorization</a></li>
+
+
+
+
+
+
+ <li><a href="basic-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="basic-signals.html">Signals</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Signal types</a>
+ <ul>
+
+
+
+ <li><a href="basic-signals-command.html">Command</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-commandresponse.html">Command response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-errorresponse.html">Error response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-event.html">Event</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-apis.html">APIs</a></li>
+
+
+
+
+
+
+ <li><a href="basic-connections.html">Connections</a></li>
+
+
+
+
+
+
+ <li><a href="basic-placeholders.html">Placeholders</a></li>
+
+
+
+
+
+
+ <li><a href="basic-changenotifications.html">Change notifications</a></li>
+
+
+
+
+
+
+ <li><a href="basic-rql.html">RQL expressions</a></li>
+
+
+
+
+
+
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
+ <li><a href="basic-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Architecture</a>
+ <ul>
+
+
+
+ <li><a href="architecture-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Services</a>
+ <ul>
+
+
+
+ <li><a href="architecture-services-policies.html">Policies</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things.html">Things</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things-search.html">Things-Search</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-connectivity.html">Connectivity</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-concierge.html">Concierge</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-gateway.html">Gateway</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>HTTP API</a>
+ <ul>
+
+
+
+ <li><a href="httpapi-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-concepts.html">Concepts</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-protocol-bindings-websocket.html">WebSocket protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-sse.html">Server sent events</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Connectivity API</a>
+ <ul>
+
+
+
+ <li><a href="connectivity-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-manage-connections.html">Manage connections</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp091.html">AMQP 0.9.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp10.html">AMQP 1.0 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li class="active"><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-kafka2.html">Kafka 2.x protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-mapping.html">Payload mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-header-mapping.html">Header mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-tls-certificates.html">TLS certificates</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Client SDK</a>
+ <ul>
+
+
+
+ <li><a href="client-sdk-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-java.html">Java</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-javascript.html">JavaScript</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Ditto Protocol</a>
+ <ul>
+
+
+
+ <li><a href="protocol-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-twinlive.html">Twin/live channel</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification.html">Specification</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-topic.html">Protocol topic</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-things.html">Things group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-delete.html">Delete</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ search/messages</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-search.html">Search</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-messages.html">Messages</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-bindings.html">Bindings</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-examples.html">Examples</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-creatething.html">Create a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletething.html">Delete a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifything.html">Modify a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievething.html">Retrieve a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethings.html">Retrieve multiple Things</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattributes.html">Delete Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattributes.html">Modify Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattributes.html">Retrieve Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattribute.html">Create a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattribute.html">Delete a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattribute.html">Modify a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattribute.html">Retrieve a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createthingdefinition.html">Create a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletethingdefinition.html">Delete a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifythingdefinition.html">Modify a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethingdefinition.html">Retrieve a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeatures.html">Create Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeatures.html">Delete Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeatures.html">Modify Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeatures.html">Retrieve Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeature.html">Create a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeature.html">Delete a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeature.html">Modify a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeature.html">Retrieve a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdefinition.html">Create Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedefinition.html">Delete Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydefinition.html">Modify Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedefinition.html">Retrieve Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperties.html">Create Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperties.html">Delete Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperties.html">Modify Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperties.html">Retrieve Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperty.html">Create a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperty.html">Delete a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperty.html">Modify a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperty.html">Retrieve a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li><a href="sandbox.html">Sandbox</a></li>
+
+
+
+
+
+ <li><a href="presentations.html">Presentations</a></li>
+
+
+
+
+
+ <li><a href="glossary.html">Glossary</a></li>
+
+
+
+
+
+ <li><a href="feedback.html">Feedback</a></li>
+
+
+
+
+
+ <p class="external">
+ <a href="#" id="collapseAll">Collapse All</a> | <a href="#" id="expandAll">Expand All</a>
+ </p>
+
+</ul>
+
+<!-- this highlights the active parent class in the sidebar. this is critical so that the parent expands when you're viewing a page. This must appear below the sidebar code above. Otherwise, if placed inside customscripts.js, the script runs before the sidebar code runs and the class never gets inserted.-->
+<script>$("li.active").parents('li').toggleClass("active");
+
+$(function() {
+ $("#dev-warning").hide();
+ changeSelectedDocVersionDropdownSelection($("#docVersion")[0]);
+ $("#docVersion").change(changeSelectedDocVersion);
+});
+
+function changeSelectedDocVersionDropdownSelection(element) {
+ var pathName = window.location.pathname;
+
+ var versionOptions = element.options;
+ for (var i = 0; i < versionOptions.length; i++) {
+ var versionValue = versionOptions[i].value;
+ if ((versionValue !== "") && pathName.startsWith("/ditto/"+versionValue+"/")) {
+ $("#docVersion").val(versionValue).change();
+ return;
+ }
+ }
+ // fallback: dev with "empty" version value:
+ $("#docVersion").val("").change();
+ $("#dev-warning").show();
+}
+function changeSelectedDocVersion() {
+ var versionValue = $('#docVersion').val();
+ var remainingPath = window.location.pathname.replace("/ditto/", "");
+ var versionMatch = remainingPath.match("([0-9].[0.9])/(.*)");
+ if (versionValue === "" && !versionMatch) {
+ // do nothing, we're already on the correct "dev" version
+ } else if (versionMatch && (versionValue === versionMatch[1])) {
+ // do nothing, we're already on the correct version
+ } else {
+ if (versionValue === "" && versionMatch) {
+ window.location.pathname = "ditto/" + versionMatch[2];
+ } else if (versionValue === "") {
+ window.location.pathname = "ditto/" + remainingPath;
+ } else if (versionMatch) {
+ window.location.pathname = "ditto/" + versionValue + "/" + versionMatch[2];
+ } else {
+ window.location.pathname = "ditto/" + versionValue + "/" + remainingPath;
+ }
+ }
+}
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">MQTT 5 protocol binding</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+
+
+
+<!-- this handles the automatic toc. use ## for subheads to auto-generate the on-page minitoc. if you use html tags, you must supply an ID for the heading element in order for it to appear in the minitoc. -->
+<script>
+$( document ).ready(function() {
+ // Handler for .ready() called.
+
+$('#toc').toc({ minimumHeaders: 0, listType: 'ul', showSpeed: 0, headers: 'h2,h3,h4' });
+
+/* this offset helps account for the space taken up by the floating toolbar. */
+$('#toc').on('click', 'a', function() {
+ var target = $(this.getAttribute('href'))
+ , scroll_target = target.offset().top
+
+ $(window).scrollTop(scroll_target - 10);
+ return false
+})
+
+});
+</script>
+
+<div id="toc"></div>
+
+
+
+
+
+
+
+
+
+ <p>Consume messages from MQTT 5 brokers via <a href="#source-format">sources</a> and send messages to MQTT 5 brokers via
+<a href="#target-format">targets</a>.</p>
+
+<h2 id="content-type">Content-type</h2>
+
+<p>When MQTT messages are sent in <a href="protocol-overview.html">Ditto Protocol</a>,
+the payload should be <code class="highlighter-rouge">UTF-8</code> encoded strings.</p>
+
+<p>If messages which are not in Ditto Protocol should be processed, a <a href="connectivity-mapping.html">payload mapping</a> must
+be configured for the connection in order to transform the messages.</p>
+
+<h2 id="mqtt-5-properties">MQTT 5 properties</h2>
+
+<p>Supported MQTT 5 properties which are interpreted in a specific way are:</p>
+
+<ul>
+ <li><code class="highlighter-rouge">9 (0x09) Correlation Data</code>: For correlating request messages and events. Twin events have the correlation IDs of
+<a href="protocol-twinlive.html#twin">Twin commands</a> that produced them. Stored in the ditto protocol header <code class="highlighter-rouge">correlation-id</code>.</li>
+ <li><code class="highlighter-rouge">8 (0x08) Response Topic</code>: The MQTT topic a requests response is expected in.
+If a command sets the header <code class="highlighter-rouge">reply-to</code>, then its response is published at the topic equal to the header value.</li>
+ <li><code class="highlighter-rouge">3 (0x03) Content Type</code>: The UTF-8 encoded string representation of the payloads content MIME type.</li>
+</ul>
+
+<h2 id="specific-connection-configuration">Specific connection configuration</h2>
+
+<p>The common configuration for connections in <a href="basic-connections.html#sources">Connections > Sources</a> and
+<a href="basic-connections.html#targets">Connections > Targets</a> applies here as well.
+Following are some specifics for MQTT connections:</p>
+
+<h3 id="source-format">Source format</h3>
+
+<p>For an MQTT connection:</p>
+
+<ul>
+ <li>Source <code class="highlighter-rouge">"addresses"</code> are MQTT topics to subscribe to. Wildcards <code class="highlighter-rouge">+</code> and <code class="highlighter-rouge">#</code> are allowed.</li>
+ <li><code class="highlighter-rouge">"authorizationContext"</code> array that contains the authorization subjects in whose context
+inbound messages are processed. These subjects may contain placeholders, see
+<a href="basic-connections.html#placeholder-for-source-authorization-subjects">placeholders</a> section for more information.</li>
+ <li>The optional field <code class="highlighter-rouge">"qos"</code> sets the maximum Quality of Service to request when subscribing for messages. Its value
+can be <code class="highlighter-rouge">0</code> for at-most-once delivery, <code class="highlighter-rouge">1</code> for at-least-once delivery and <code class="highlighter-rouge">2</code> for exactly-once delivery.
+The default value is <code class="highlighter-rouge">2</code> (exactly-once).
+Support of any Quality of Service depends on the external MQTT broker</li>
+</ul>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"addresses"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
+ </span><span class="s2">"<mqtt_topic>"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"..."</span><span class="w">
+ </span><span class="p">],</span><span class="w">
+ </span><span class="s2">"authorizationContext"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">"ditto:inbound-auth-subject"</span><span class="p">,</span><span class="w"> </span><span class="s2">"..."</span><span class="p">],</span><span class="w">
+ </span><span class="s2">"qos"</span><span class="p">:</span><span class="w"> </span><span class="mi">2</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h4 id="source-header-mapping">Source header mapping</h4>
+
+<p>MQTT 5 supports so-called user defined properties, which are defined for every message type. The <a href="connectivity-header-mapping.html">header mapping</a> applies to the supported MQTT 5 specific headers as well as to the user defined properties.</p>
+
+<h3 id="target-format">Target format</h3>
+
+<p>For an MQTT connection, the target address is the MQTT topic to publish events and messages to.
+The target address may contain placeholders; see
+<a href="basic-connections.html#placeholder-for-target-addresses">placeholders</a> section for more information.</p>
+
+<p>Further, <code class="highlighter-rouge">"topics"</code> is a list of strings, each list entry representing a subscription of
+<a href="protocol-specification-topic.html">Ditto protocol topics</a>.</p>
+
+<p>Outbound messages are published to the configured target address if one of the subjects in <code class="highlighter-rouge">"authorizationContext"</code>
+has READ permission on the Thing, that is associated with a message.</p>
+
+<p>The additional field <code class="highlighter-rouge">"qos"</code> sets the Quality of Service with which messages are published.
+Its value can be <code class="highlighter-rouge">0</code> for at-most-once delivery, <code class="highlighter-rouge">1</code> for at-least-once delivery and <code class="highlighter-rouge">2</code> for exactly-once delivery.
+Support of any Quality of Service depends on the external MQTT broker.
+The default value is <code class="highlighter-rouge">0</code> (at-most-once).</p>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"address"</span><span class="p">:</span><span class="w"> </span><span class="s2">"mqtt/topic/of/my/device/{{ thing:id }}"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"topics"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
+ </span><span class="s2">"_/_/things/twin/events"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"_/_/things/live/messages"</span><span class="w">
+ </span><span class="p">],</span><span class="w">
+ </span><span class="s2">"authorizationContext"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">"ditto:outbound-auth-subject"</span><span class="p">,</span><span class="w"> </span><span class="s2">"..."</span><span class="p">],</span><span class="w">
+ </span><span class="s2">"qos"</span><span class="p">:</span><span class="w"> </span><span class="mi">0</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h4 id="target-header-mapping">Target header mapping</h4>
+
+<p>MQTT 5 supports so-called user defined properties, which are defined for every message type. The <a href="connectivity-header-mapping.html">header mapping</a> applies to the supported MQTT 5 specific headers as well as to the user defined properties.</p>
+
+<p>In order to provide user defined properties for the targets of the MQTT 5 connector, use the <a href="basic-connections.html#specific-config">specific configs</a> field of the connector configuration. The entries are interpreted as key-value-pairs and directly set as user properties.</p>
+
+<h2 id="establishing-a-connection-to-an-mqtt-5-endpoint">Establishing a connection to an MQTT 5 endpoint</h2>
+
+<p>Ditto’s <a href="architecture-services-connectivity.html">Connectivity service</a> is responsible for creating new and managing
+existing connections.</p>
+
+<p>This can be done dynamically at runtime without the need to restart any microservice using a
+<a href="installation-operating.html#devops-commands">Ditto DevOps command</a>.</p>
+
+<p>Example</p>
+
+<p>Connection configuration to create a new MQTT connection:</p>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"mqtt-example-connection-12"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"connectionType"</span><span class="p">:</span><span class="w"> </span><span class="s2">"mqtt-5"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"connectionStatus"</span><span class="p">:</span><span class="w"> </span><span class="s2">"open"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"failoverEnabled"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"uri"</span><span class="p">:</span><span class="w"> </span><span class="s2">"tcp://test.mosquitto.org:1883"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"sources"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
+ </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"addresses"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
+ </span><span class="s2">"eclipse-ditto-sandbox/#"</span><span class="w">
+ </span><span class="p">],</span><span class="w">
+ </span><span class="s2">"authorizationContext"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">"ditto:inbound-auth-subject"</span><span class="p">],</span><span class="w">
+ </span><span class="s2">"qos"</span><span class="p">:</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"filters"</span><span class="p">:</span><span class="w"> </span><span class="p">[]</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">],</span><span class="w">
+ </span><span class="s2">"targets"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
+ </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"address"</span><span class="p">:</span><span class="w"> </span><span class="s2">"eclipse-ditto-sandbox/{{ thing:id }}"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"topics"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
+ </span><span class="s2">"_/_/things/twin/events"</span><span class="w">
+ </span><span class="p">],</span><span class="w">
+ </span><span class="s2">"authorizationContext"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">"ditto:outbound-auth-subject"</span><span class="p">],</span><span class="w">
+ </span><span class="s2">"qos"</span><span class="p">:</span><span class="w"> </span><span class="mi">0</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">]</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="client-certificate-authentication">Client-certificate authentication</h2>
+
+<p>Ditto supports certificate-based authentication for MQTT connections. Consult
+<a href="connectivity-tls-certificates.html">Certificates for Transport Layer Security</a>
+for how to set it up.</p>
+
+<p>Here is an example MQTT connection that checks the broker certificate and authenticates by a client certificate.</p>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"mqtt-example-connection-124"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"connectionType"</span><span class="p">:</span><span class="w"> </span><span class="s2">"mqtt-5"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"connectionStatus"</span><span class="p">:</span><span class="w"> </span><span class="s2">"open"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"failoverEnabled"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"uri"</span><span class="p">:</span><span class="w"> </span><span class="s2">"ssl://test.mosquitto.org:8884"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"validateCertificates"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"ca"</span><span class="p">:</span><span class="w"> </span><span class="s2">"-----BEGIN CERTIFICATE-----</span><span class="se">\n</span><span class="s2"><test.mosquitto.org certificate></span><span class="se">\n</span><span class="s2">-----END CERTIFICATE-----"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"credentials"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"client-cert"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"cert"</span><span class="p">:</span><span class="w"> </span><span class="s2">"-----BEGIN CERTIFICATE-----</span><span class="se">\n</span><span class="s2"><signed client certificate></span><span class="se">\n</span><span class="s2">-----END CERTIFICATE-----"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"key"</span><span class="p">:</span><span class="w"> </span><span class="s2">"-----BEGIN PRIVATE KEY-----</span><span class="se">\n</span><span class="s2"><client private key></span><span class="se">\n</span><span class="s2">-----END PRIVATE KEY-----"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"sources"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
+ </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"addresses"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
+ </span><span class="s2">"eclipse-ditto-sandbox/#"</span><span class="w">
+ </span><span class="p">],</span><span class="w">
+ </span><span class="s2">"authorizationContext"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">"ditto:inbound-auth-subject"</span><span class="p">],</span><span class="w">
+ </span><span class="s2">"qos"</span><span class="p">:</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"filters"</span><span class="p">:</span><span class="w"> </span><span class="p">[]</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">],</span><span class="w">
+ </span><span class="s2">"targets"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
+ </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"address"</span><span class="p">:</span><span class="w"> </span><span class="s2">"eclipse-ditto-sandbox/{{ thing:id }}"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"topics"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
+ </span><span class="s2">"_/_/things/twin/events"</span><span class="w">
+ </span><span class="p">],</span><span class="w">
+ </span><span class="s2">"authorizationContext"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">"ditto:outbound-auth-subject"</span><span class="p">],</span><span class="w">
+ </span><span class="s2">"qos"</span><span class="p">:</span><span class="w"> </span><span class="mi">0</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">]</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+
+ <div class="tags">
+
+ <b>Tags: </b>
+
+
+
+ <a href="tag_protocol.html" class="btn btn-default navbar-btn cursorNorm" role="button">protocol</a>
+
+
+
+ <a href="tag_connectivity.html" class="btn btn-default navbar-btn cursorNorm" role="button">connectivity</a>
+
+
+
+ </div>
+
+</div>
+
+<hr class="shaded"/>
+
+<footer>
+ <div class="row">
+ <div class="col-lg-12 footer">
+ <div class="logo">
+ <a href="https://eclipse.org"><img src="images/eclipse_foundation_logo.svg" alt="Eclipse logo"/></a>
+ </div>
+ <p class="notice">
+ ©2020 Eclipse Ditto.
+ Site last generated: Jul 1, 2020 <br />
+ </p>
+ <div class="quickLinks">
+ <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
+ > Privacy Policy
+ </a>
+ <a href="https://www.eclipse.org/legal/termsofuse.php" target="_blank">
+ > Terms of Use
+ </a>
+ <a href="https://www.eclipse.org/legal/copyright.php" target="_blank">
+ > Copyright Agent
+ </a>
+ <a href="https://www.eclipse.org/legal" target="_blank">
+ > Legal
+ </a>
+ <a href="https://www.eclipse.org/legal/epl-2.0/" target="_blank">
+ > License
+ </a>
+ <a href="https://eclipse.org/security" target="_blank">
+ > Report a Vulnerability
+ </a>
+ </div>
+ </div>
+ </div>
+</footer>
+
+
+ </div>
+ <!-- /.row -->
+</div>
+<!-- /.container -->
+</div>
+<!-- /#main -->
+ </div>
+
+</body>
+</html>
diff --git a/1.0/connectivity-tls-certificates.html b/1.0/connectivity-tls-certificates.html
index 696da2a..50e30e6 100644
--- a/1.0/connectivity-tls-certificates.html
+++ b/1.0/connectivity-tls-certificates.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1388,7 +1609,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/feedback.html b/1.0/feedback.html
index 1a9715d..07d7832 100644
--- a/1.0/feedback.html
+++ b/1.0/feedback.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1294,7 +1515,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/files/migration_mongodb_1.0.0.js b/1.0/files/migration_mongodb_1.0.0.js
index 2035a62..e2be0b4 100644
--- a/1.0/files/migration_mongodb_1.0.0.js
+++ b/1.0/files/migration_mongodb_1.0.0.js
@@ -1,71 +1,236 @@
-function insertDocuments(collection, documents) {
- const ids = [];
- const bulkWrites = [];
+/**
+ * Database Migration 1.0.0
+ *
+ * This script migrates the suffixed journals and snapshot stores of things and policies before 1.0.0 to
+ * non-suffixed journals and snapshot stores post 1.0.0.
+ *
+ * === Prerequisite ===
+ *
+ * - Backup your database.
+ *
+ * - Enable server-side-scripting for your MongoDB:
+ * This script uses server-side scripting to avoid transferring near the entire database across a network interface.
+ *
+ * === Usage: Multi-database setup ===
+ *
+ * 1. Connect to the MongoDB by Mongo Shell.
+ * 2. Paste this script into Mongo Shell.
+ * 3. Type the following into Mongo Shell:
+ *
+ * use things # replace 'things' by the name of your things-service database
+ * migrateThings();
+ * use policies # replace 'policies' by the name of your policies-service database
+ * migratePolicies();
+ *
+ * === Usage: Single-database setup ===
+ *
+ * 1. Connect to t he MongoDB by Mongo Shell.
+ * 2. Use the single database of your Ditto installation.
+ * 3. Type the following into Mongo Shell:
+ *
+ * migrate();
+ *
+ * === Revert ===
+ *
+ * If there is an exception before suffixed collections are dropped (i. e., before the line
+ * "Dropping suffixed collections" show up in the log), migration can be reverted by calling the function
+ *
+ * revert()
+ *
+ * in things- or policies-database, or in the single database of a single-database setup.
+ *
+ * === Index creation ===
+ *
+ * Indexes are created by the persistence plugin of Ditto after creating a thing and a policy and after writing a thing-
+ * and a policy-snapshot. Expect unresponsive persistence or sporadic circuit-breaker errors for some time after service
+ * startup. To trigger journal and snapshot writes, create a new V2 thing without specifying a policy: journal writes
+ * happen immediately and snapshot writes happen 15 minutes later under the default configuration.
+ */
- documents.forEach(document => {
- const {_id} = document;
+const THINGS_JOURNAL = 'things_journal';
+const THINGS_SNAPS = 'things_snaps';
+const POLICIES_JOURNAL = 'policies_journal';
+const POLICIES_SNAPS = 'policies_snaps';
- ids.push(_id);
- bulkWrites.push({
- replaceOne: {
- filter: {_id},
- replacement: document,
- upsert: true
- }
- })
- });
-
- if (bulkWrites.length > 0) {
- collection.bulkWrite(bulkWrites, {ordered: false});
- }
-
- return ids;
+function reduceStep(key, values) {
+ return values;
}
-function copyDocuments(sourceCollection, targetCollection, filter) {
- const sourceDocs = sourceCollection.find(filter);
- print(`Copy ${sourceDocs.count()} documents from ${sourceCollection} to ${targetCollection} ...`);
- insertDocuments(targetCollection, sourceDocs);
- print('Done!');
+function finalizeStep(key, values) {
+ let value = values;
+ if (Array.isArray(values)) {
+ if (values.length !== 1) {
+ throw JSON.stringify(values);
+ }
+ value = values[0];
+ }
+ return value;
+}
+
+function checkOk(result) {
+ printjson(result);
+ if (result.ok !== 1) {
+ throw JSON.stringify(result);
+ }
+}
+
+/**
+ * Copy all documents of source collection into target collection by map-reduce.
+ * Due to the fixed output schema of map-reduce, the original document is under the field 'value'.
+ * The target collection retains its previous documents.
+ * Duplicate IDs abort the operation with an error.
+ *
+ * @param sourceCollection Name of the source collection.
+ * @param targetCollection Name of the target collection.
+ */
+function copyDocuments(sourceCollection, targetCollection) {
+ const sourceJournal = db.getCollection(sourceCollection);
+ const targetExists = db.getCollection(targetCollection).count() !== 0;
+ const out = targetExists ? { reduce: targetCollection } : targetCollection;
+ print(`Copy ${sourceJournal.count()} documents from ${sourceCollection} to ${targetCollection} ...`);
+ checkOk(db.runCommand({
+ mapReduce: sourceCollection,
+ map: function() { emit(this._id, this); },
+ reduce: reduceStep,
+ finalize: finalizeStep,
+ out: out
+ }));
+}
+
+function checkEmpty(collectionName) {
+ const collection = db.getCollection(collectionName);
+ if (collection.count() !== 0) {
+ throw "Target collection " + collection + " is not empty!";
+ }
+ return collection;
+}
+
+/**
+ * Prefix of collections to delete.
+ *
+ * @type {string}
+ */
+const TO_DELETE = 'z_delete_';
+
+function renameToDelete(collection) {
+ const c = db.getCollection(collection);
+ checkOk(c.renameCollection(TO_DELETE + collection));
+}
+
+/**
+ * Convert a journal collection from map-reduce format to event journal format.
+ *
+ * @param collection The journal collection name.
+ */
+function unmapJournal(collection) {
+ db[collection].aggregate([
+ {
+ $project:{
+ _id: 1,
+ pid: '$value.pid',
+ from: '$value.from',
+ to: '$value.to',
+ events: '$value.events',
+ v: '$value.v',
+ _tg: '$value._tg'
+ }
+ },
+ {$out: collection}
+ ]);
+}
+
+/**
+ * Convert a snapshot store from map-reduce format to snapshot store format.
+ *
+ * @param collection The snapshot store collection name.
+ */
+function unmapSnaps(collection) {
+ db[collection].aggregate([
+ {
+ $project:{
+ _id: 1,
+ pid: '$value.pid',
+ sn: '$value.sn',
+ ts: '$value.ts',
+ s2: '$value.s2'
+ }
+ },
+ {$out: collection}
+ ]);
+}
+
+/**
+ * Migrate journal and snapshot store for things or policies
+ *
+ * @param targetJournalName Name of the target journal collection---must be empty.
+ * @param targetSnapsName Name of the target snapshot store collection---must be empty.
+ */
+function migrateThingsOrPolicies(targetJournalName, targetSnapsName) {
+ const targetJournal = checkEmpty(targetJournalName);
+ const targetSnaps = checkEmpty(targetSnapsName);
+ db.getCollectionNames()
+ .filter(name => name.includes(targetJournalName + '@'))
+ .forEach(collectionName => {
+ copyDocuments(collectionName, targetJournalName);
+ renameToDelete(collectionName);
+ });
+
+ db.getCollectionNames()
+ .filter(name => name.includes(targetSnapsName + '@'))
+ .forEach(collectionName => {
+ copyDocuments(collectionName, targetSnapsName);
+ renameToDelete(collectionName);
+ });
+
+ print(`Unmapping ${targetJournal.count()} events ...`);
+ unmapJournal(targetJournalName);
+ print(`Unmapping ${targetSnaps.count()} snapshots ...`);
+ unmapSnaps(targetSnapsName);
+ print('Done.');
}
function migratePolicies() {
- const db = Mongo().getDB("policies");
- const targetJournal = db.getCollection('policies_journal');
- db.getCollectionNames()
- .filter(name => name.includes('policies_journal@'))
- .forEach(collectionName => {
- const sourceJournal = db.getCollection(collectionName);
- copyDocuments(sourceJournal, targetJournal);
- });
-
- const targetSnaps = db.getCollection('policies_snaps');
- db.getCollectionNames()
- .filter(name => name.includes('policies_snaps@'))
- .forEach(collectionName => {
- const sourceSnaps = db.getCollection(collectionName);
- copyDocuments(sourceSnaps, targetSnaps);
- });
+ migrateThingsOrPolicies(POLICIES_JOURNAL, POLICIES_SNAPS);
}
function migrateThings() {
- const db = Mongo().getDB("things");
- const targetJournal = db.getCollection('things_journal');
- db.getCollectionNames()
- .filter(name => name.includes('things_journal@'))
- .forEach(collectionName => {
- const sourceJournal = db.getCollection(collectionName);
- copyDocuments(sourceJournal, targetJournal);
- });
-
- const targetSnaps = db.getCollection('things_snaps');
- db.getCollectionNames()
- .filter(name => name.includes('things_snaps@'))
- .forEach(collectionName => {
- const sourceSnaps = db.getCollection(collectionName);
- copyDocuments(sourceSnaps, targetSnaps);
- });
+ migrateThingsOrPolicies(THINGS_JOURNAL, THINGS_SNAPS);
}
-migratePolicies();
-migrateThings();
\ No newline at end of file
+function dropAllToDelete() {
+ print("Dropping all suffixed collections...")
+ db.getCollectionNames()
+ .filter(name => name.includes(TO_DELETE))
+ .forEach(collectionName => db.getCollection(collectionName).drop());
+ print("Done.")
+}
+
+/**
+ * Migrate things and policies.
+ * If any error aborts the migration, run 'revert()' to restore to previous state.
+ */
+function migrate() {
+ migratePolicies();
+ migrateThings();
+ dropAllToDelete();
+}
+
+/**
+ * Revert the migration.
+ */
+function revert() {
+ db.getCollectionNames()
+ .filter(name => name.includes(TO_DELETE))
+ .forEach(collectionName => db.getCollection(collectionName)
+ .renameCollection(collectionName.substring(TO_DELETE.length, collectionName.length)));
+ db.getCollection(THINGS_JOURNAL).drop();
+ db.getCollection(THINGS_SNAPS).drop();
+ db.getCollection(POLICIES_JOURNAL).drop();
+ db.getCollection(POLICIES_SNAPS).drop();
+}
+
+// Choose one of 'migrate()' or 'revert()'.
+// migrate();
+// revert();
+
+// Expect high database resource consumption on service startup due to index creation.
diff --git a/1.0/glossary.html b/1.0/glossary.html
index e3fc6fe..d772cbf 100644
--- a/1.0/glossary.html
+++ b/1.0/glossary.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1282,7 +1503,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/http-api-doc.html b/1.0/http-api-doc.html
index 317d664..74e8345 100644
--- a/1.0/http-api-doc.html
+++ b/1.0/http-api-doc.html
@@ -201,7 +201,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
@@ -237,7 +237,7 @@
// Build a system
window.ui = SwaggerUIBundle({
urls: [
- {url: "openapi/ditto-api-1.yml", name:"Ditto API v1"},
+ {url: "openapi/ditto-api-1.yml", name: "Ditto API v1- deprecated"},
{url: "openapi/ditto-api-2.yml", name:"Ditto API v2"}
],
"urls.primaryName": "Ditto API v2",
diff --git a/1.0/httpapi-concepts.html b/1.0/httpapi-concepts.html
index f3ca252..400ded6 100644
--- a/1.0/httpapi-concepts.html
+++ b/1.0/httpapi-concepts.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1256,7 +1477,7 @@
<h2 id="api-versioning">API versioning</h2>
-<p>Ditto’s HTTP API is versioned in the URL: <code class="highlighter-rouge">/api/<apiVersion></code>. Currently Ditto distinguishes between API version <code class="highlighter-rouge">1</code> and
+<p>Ditto’s HTTP API is versioned in the URL: <code class="highlighter-rouge">/api/<apiVersion></code>. Currently Ditto distinguishes between deprecated API version <code class="highlighter-rouge">1</code> and
API version <code class="highlighter-rouge">2</code>.</p>
<p>The API version is a promise that no HTTP resources (the static ones defined by Ditto itself) are modified in an
@@ -1275,10 +1496,41 @@
representation of the model classes, e.g. <a href="basic-thing.html#model-specification">Thing</a> for the layout of the <code class="highlighter-rouge">/things</code>
endpoint and <a href="basic-policy.html">Policy</a> for the layout of the <code class="highlighter-rouge">/policies</code> endpoint.</p>
-<h3 id="api-version-1">API version 1</h3>
+<h3 id="api-version-1---deprecated">API version 1 - Deprecated</h3>
<p>In API version 1, each <code class="highlighter-rouge">Thing</code> contains the information about the authorization in an inlined <a href="basic-acl.html">ACL</a>.</p>
+<h4 id="migration-from-api-1-to-api-2">Migration from API 1 to API 2</h4>
+
+<p>In case you need to migrate a thing which was created via API 1 to API 2,
+please note that you need to migrate the access control list entries (ACL) into a <strong>policy</strong>, and to assign your thing to such a policy.</p>
+
+<ol>
+ <li>
+ <p>Request the thing to be migrated, via API 2 and use the field-selector to specify that the inline policy (i.e. <code class="highlighter-rouge">_policy</code>) should also be retrieved.</p>
+
+ <p><code class="highlighter-rouge">GET /api/2/things/{$thingId}?fields=_policy</code></p>
+
+ <p><a href="https://www.eclipse.org/ditto/http-api-doc.html#/Things/get_things__thingId_">Retrieve a specific Thing</a></p>
+ </li>
+ <li>
+ <p>Create a new policy from the content of the requested inline policy, with a <code class="highlighter-rouge">policyId</code> of your choice (e.g. same as the <code class="highlighter-rouge">thingId</code>).</p>
+
+ <p><code class="highlighter-rouge">PUT /api/2/policies/{$policyId}</code></p>
+
+ <p><a href="https://www.eclipse.org/ditto/http-api-doc.html#/Policies/put_policies__policyId_">Create or update a Policy with a specified ID</a></p>
+ </li>
+ <li>
+ <p>Assign the new <code class="highlighter-rouge">policyId</code> to the thing to be migrated.</p>
+
+ <p><code class="highlighter-rouge">PUT /api/2/things/{$thingId}/policyId</code></p>
+
+ <p><a href="https://www.eclipse.org/ditto/http-api-doc.html#/Things/put_things__thingId__policyId">Create or update the Policy ID of a Thing</a></p>
+ </li>
+</ol>
+
+<p><strong>Note</strong>: Henceforth the thing cannot be read nor written via API 1.</p>
+
<h4 id="things-in-api-1"><code class="highlighter-rouge">/things</code> in API 1</h4>
<p>The base endpoint for accessing and working with <code class="highlighter-rouge">Things</code>.<br />
@@ -1697,6 +1949,25 @@
However, we discourage the usage of weak entity-tags, because in the context of Ditto they only add unnecessary
complexity.</p>
+<h3 id="exempted-fields">Exempted fields</h3>
+
+<p>Assuming you have a thing with an associated policy. When querying the thing with</p>
+
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>GET .../things/{thingId}?fields=_policy
+</code></pre></div></div>
+
+<p>you will get the thing containing its revision and associated policy.</p>
+
+<p>If you now modify the associated policy, the revision of the thing will not change! This could lead to an
+inconsistent state if the thing is getting refetched by using the <code class="highlighter-rouge">If-None-Match</code> header,
+because this would return a <code class="highlighter-rouge">304 Not Modified</code>, even if the policy has changed.</p>
+
+<p>To tackle this, Ditto has the following list of exempted fields which automatically bypass the precondition header check:</p>
+
+<ul>
+ <li><code class="highlighter-rouge">_policy</code></li>
+</ul>
+
<h3 id="examples">Examples</h3>
<p>The following examples show several scenarios on a top-level (Thing) resource. Nevertheless, these scenarios can
@@ -1818,7 +2089,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/httpapi-messages.html b/1.0/httpapi-messages.html
index 75ab401..2a6d469 100644
--- a/1.0/httpapi-messages.html
+++ b/1.0/httpapi-messages.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1370,7 +1591,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/httpapi-overview.html b/1.0/httpapi-overview.html
index 5656b1d..15e5a9c 100644
--- a/1.0/httpapi-overview.html
+++ b/1.0/httpapi-overview.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1290,7 +1511,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/httpapi-protocol-bindings-websocket.html b/1.0/httpapi-protocol-bindings-websocket.html
index d8fbd57..e3d1b22 100644
--- a/1.0/httpapi-protocol-bindings-websocket.html
+++ b/1.0/httpapi-protocol-bindings-websocket.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1439,6 +1660,50 @@
</tbody>
</table>
+<h3 id="enrichment">Enrichment</h3>
+
+<div class="bs-callout bs-callout-primary">Available since Ditto <strong>1.1.0</strong></div>
+
+<p>When extra fields should be added to outgoing messages on the WebSocket channel, an <code class="highlighter-rouge">extraFields</code> parameter can be added
+to the request message. This is supported for all request messages:</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Description</th>
+ <th>Request message</th>
+ <th><a href="basic-enrichment.html">Enrich by extra fields</a></th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>Subscribe for <a href="basic-changenotifications.html">events/change notifications</a></td>
+ <td><code class="highlighter-rouge">START-SEND-EVENTS</code></td>
+ <td>✔</td>
+ </tr>
+ <tr>
+ <td>Subscribe for <a href="basic-messages.html">messages</a></td>
+ <td><code class="highlighter-rouge">START-SEND-MESSAGES</code></td>
+ <td>✔</td>
+ </tr>
+ <tr>
+ <td>Subscribe for <a href="protocol-twinlive.html">live commands</a></td>
+ <td><code class="highlighter-rouge">START-SEND-LIVE-COMMANDS</code></td>
+ <td>✔</td>
+ </tr>
+ <tr>
+ <td>Subscribe for <a href="protocol-twinlive.html">live events</a></td>
+ <td><code class="highlighter-rouge">START-SEND-LIVE-EVENTS</code></td>
+ <td>✔</td>
+ </tr>
+ </tbody>
+</table>
+
+<p>Analog to the <a href="#filtering">filtering</a> the parameter is defined like an HTTP query parameter, e.g.:</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>START-SEND-EVENTS?extraFields=attributes/counter,features/ConnectionStatus
+START-SEND-MESSAGES?extraFields=attributes
+</code></pre></div></div>
+
<h3 id="filtering">Filtering</h3>
<p>In order to only consume specific events like described in <a href="basic-changenotifications.html">change notifications</a>, the
@@ -1449,8 +1714,8 @@
<tr>
<th>Description</th>
<th>Request message</th>
- <th>Filter by namespaces</th>
- <th>Filter by RQL expression</th>
+ <th><a href="basic-changenotifications.html#by-namespaces">Filter by namespaces</a></th>
+ <th><a href="basic-changenotifications.html#by-rql-expression">Filter by RQL expression</a></th>
</tr>
</thead>
<tbody>
@@ -1489,6 +1754,10 @@
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>START-SEND-EVENTS?namespaces=org.eclipse.ditto&filter=gt(attributes/counter,42)
</code></pre></div></div>
+<p>The filtering may be also used in combination with an <a href="#enrichment">enrichment</a>, e.g.:</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>START-SEND-EVENTS?extraFields=attributes&filter=gt(attributes/counter,42)
+</code></pre></div></div>
+
<div class="tags">
@@ -1522,7 +1791,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/httpapi-search.html b/1.0/httpapi-search.html
index 4175794..9b503e5 100644
--- a/1.0/httpapi-search.html
+++ b/1.0/httpapi-search.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1268,7 +1489,8 @@
<h2 id="query-parameters">Query parameters</h2>
<p>In order to define for which <code class="highlighter-rouge">Things</code> to search, the <code class="highlighter-rouge">filter</code> query parameter has to be added.<br />
-In order to change the sorting and limit the result (also to do paging), the <code class="highlighter-rouge">options</code> parameter has to be added.</p>
+In order to change the sorting and limit the result (also to do paging), the <code class="highlighter-rouge">option</code> parameter has to be added.
+Default values of each option is documented <a href="basic-search.html#sorting-and-paging-options">here</a>.</p>
<p>Complex example:</p>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>GET .../search/things?filter=eq(attributes/location,"living-room")&option=sort(+thingId),limit(0,5)&namespaces=org
@@ -1336,7 +1558,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/httpapi-sse.html b/1.0/httpapi-sse.html
index 6152254..aab2ffd 100644
--- a/1.0/httpapi-sse.html
+++ b/1.0/httpapi-sse.html
@@ -5,7 +5,7 @@
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="description" content="">
-<meta name="keywords" content="httprql, http, api, sse, EventSource">
+<meta name="keywords" content="httprql, http, api, sse, EventSource, fields, projection, extra, enrich">
<title> HTTP API server sent events (SSE) • Eclipse Ditto • a digital twin framework</title>
<link rel="stylesheet" href="css/syntax.css">
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1248,60 +1469,61 @@
- <p>HTML5 <a href="#" data-toggle="tooltip" data-original-title="Server Sent Events - one way messaging/push from a HTTP server to a consuming client (e.g. a browser).">SSEs</a> may be used in order
-to get notified when the state of <strong>digital twins</strong> change.</p>
-
-<p>This is the second mechanism of Ditto in order to get <a href="basic-changenotifications.html">change notifications</a>.
-The benefit of this mechanism in contrary to the <a href="httpapi-protocol-bindings-websocket.html">WebSocket</a> channel is that it is
-even easier to open a SSE connection from the client than a WebSocket and that in Ditto’s interpretation of SSEs the
-events sent back from the backend have the same JSON structure as the HTTP API on which they are invoked.</p>
+ <p>Server-Sent Events (<a href="#" data-toggle="tooltip" data-original-title="Server Sent Events - one way messaging/push from a HTTP server to a consuming client (e.g. a browser).">SSEs</a>)
+can be used to get notified when the state of <strong>digital twins</strong> change, and to receive a
+<a href="basic-search.html">search results</a> stream.</p>
<h2 id="server-sent-events">Server-Sent Events</h2>
-<p>Different as WebSockets, Server-Sent Events are unidirectional originating from the back-end towards the client. Via SSEs
-the client can only be notified, it cannot send data back (it can use plain HTTP therefore).</p>
+<p>Server-Sent Events are unidirectional originating from the back-end towards the client. Via SSEs
+the client can only be notified, it cannot send data back (it can use plain HTTP for that).</p>
<p>For a detailed introduction into SSEs, please visit
the <a href="https://html.spec.whatwg.org/multipage/server-sent-events.html">HTML5 specification</a>.</p>
-<div class="alert alert-danger" role="alert"><i class="fa fa-exclamation-circle"></i> <b>Warning:</b> Although SSEs are a HTML5 standard, they still cannot be used in every browser:
- see <a href="https://caniuse.com/#search=Server-sent%20events">caniuse.com</a> - Microsoft IE11 and Edge browser still doesn’t support them.</div>
+<div class="alert alert-danger" role="alert"><i class="fa fa-exclamation-circle"></i> <b>Warning:</b> Although SSEs are a HTML5 standard, they still cannot be used with the Microsoft
+Internet Explorer on the client side or anything behind a Microsoft Azure Application Gateway on the server side.</div>
<h3 id="sses-in-javascript">SSEs in JavaScript</h3>
-<p>Using the <code class="highlighter-rouge">EventSource</code> object in JavaScript is also well covered in the <a href="https://html.spec.whatwg.org/multipage/server-sent-events.html#server-sent-events-intro">HTML5 specification</a>.</p>
+<p>Using the <code class="highlighter-rouge">EventSource</code> object in JavaScript is also covered in the <a href="https://html.spec.whatwg.org/multipage/server-sent-events.html#server-sent-events-intro">HTML5 specification</a>.</p>
<h2 id="sse-api-things">SSE API <code class="highlighter-rouge">/things</code></h2>
-<p>Currently the only supported HTTP API for receiving <a href="#" data-toggle="tooltip" data-original-title="Server Sent Events - one way messaging/push from a HTTP server to a consuming client (e.g. a browser).">SSEs</a>
-is the <code class="highlighter-rouge">/things</code> endpoint:</p>
+<p>The SSE API for receiving <a href="basic-changenotifications.html">change notifications</a> is the <code class="highlighter-rouge">/things</code> endpoint:</p>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>http://localhost:8080/api/<1|2>/things
</code></pre></div></div>
-<p>When the endpoint is invoked with an HTTP header <code class="highlighter-rouge">Accept</code> with value <code class="highlighter-rouge">text/event-stream</code>, an Server-Sent Event stream of
-<a href="basic-changenotifications.html">change notifications</a> is created by Ditto and for each notification for which the caller
-has READ permissions (see <a href="basic-auth.html#authorization">authorization</a>), a message is sent to the client.</p>
+<p>This is a mechanism to get <a href="basic-changenotifications.html">change notifications</a>.
+The benefit of this mechanism in comparison to the <a href="httpapi-protocol-bindings-websocket.html">WebSocket</a> channel is, that it is
+even easier to open a SSE connection from the client than a WebSocket, and that in Ditto’s interpretation of SSEs the
+events sent back from the backend have the same JSON structure as the HTTP API on which they are invoked.</p>
-<p>The format of the message at the <code class="highlighter-rouge">/things</code> endpoint is always in the form of a <a href="basic-thing.html#model-specification">Thing JSON</a>
-(in API 1 format or API 2 format depending on which edpoint the SSE was created).</p>
+<p>When the endpoint is invoked with an HTTP header <code class="highlighter-rouge">Accept</code> with value <code class="highlighter-rouge">text/event-stream</code>, a Server-Sent Event stream of
+<a href="basic-changenotifications.html">change notifications</a> is created by Ditto and for each notification for which the caller
+has READ permissions (see <a href="basic-auth.html#authorization">authorization</a>), an event is sent to the client.</p>
+
+<p>The format of the event at the <code class="highlighter-rouge">/things</code> endpoint is always in the form of a <a href="basic-thing.html#model-specification">Thing JSON</a>
+(in API 1 format or API 2 format depending on which endpoint the SSE was created).</p>
<p>For partial updates to a <code class="highlighter-rouge">Thing</code> however, only the changed part is sent back via the SSE, not the complete <code class="highlighter-rouge">Thing</code>.</p>
-<h3 id="only-get-notified-about-certain-changes">Only get notified about certain changes</h3>
+<h3 id="only-get-notified-about-specific-changes">Only get notified about specific changes</h3>
<p>In order to apply a server side filtering of which Server-Sent Events should be emitted to a consumer, Ditto provides
several possibilities listed in the sections below.</p>
-<p>All of the query parameters below can be combined, so that you can for example formulate that only events from a certain
-namespace with a specific RQL expression should be emitted which could look like:</p>
+<p>All of the query parameters below can be combined, so that you can for example express that only events from
+a certain namespace with a specific RQL expression should be emitted, which could look like:</p>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>http://localhost:8080/api/<1|2>/things?namespaces=org.eclipse.ditto.one,org.eclipse.test&filter=gt
(attributes/counter,42)
</code></pre></div></div>
-<h4 id="specify-the-thing-ids">Specify the Thing IDs</h4>
+<h4 id="specify-the-ids-of-the-things">Specify the IDs of the Things</h4>
-<p>When the <code class="highlighter-rouge">/things</code> endpoint is used for connecting to the SSE stream, all for the authenticated user visible <code class="highlighter-rouge">Things</code> are
-included in the stream. If only specific <code class="highlighter-rouge">Things</code> should be watched, the query parameter <code class="highlighter-rouge">ids</code> can be added:</p>
+<p>When the <code class="highlighter-rouge">/things</code> endpoint is used for connecting to the SSE stream, all
+things visible for the authenticated user are
+included in the stream. If only specific things should be watched, the query parameter <code class="highlighter-rouge">ids</code> can be added:</p>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>http://localhost:8080/api/<1|2>/things?ids=<thingId1>,<thingId2>
</code></pre></div></div>
@@ -1313,12 +1535,27 @@
</code></pre></div></div>
<div class="alert alert-success" role="alert"><i class="fa fa-check-square-o"></i> <b>Tip:</b> The <code class="highlighter-rouge">thingId</code> should always be included in the <code class="highlighter-rouge">fields</code> query, otherwise it is no longer
- reproducible, for which Thing the change was made.</div>
+ visible for which thing the change was made.</div>
+
+<h4 id="field-enrichment">Field enrichment</h4>
+
+<div class="bs-callout bs-callout-primary">Available since Ditto <strong>1.1.0</strong></div>
+
+<p>In addition to the fields projection, one can also choose to select <a href="basic-enrichment.html">extra fields</a>
+to return in addition to the actually changed fields, e.g.:</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>http://localhost:8080/api/<1|2>/things?extraFields=attributes
+</code></pre></div></div>
+
+<p>The result is, that the server-sent events are merged, i.e. the SSE contains the actually changed data + the extra fields.</p>
+
+<p>This can be used in combination with the below mentioned <a href="#filtering-by-rql-expression">RQL filter</a>, e.g.:</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>http://localhost:8080/api/<1|2>/things?extraFields=attributes/location&filter=eq(attributes/location,"kitchen")
+</code></pre></div></div>
<h4 id="filtering-by-namespaces">Filtering by namespaces</h4>
-<p>As described in <a href="basic-changenotifications.html#by-namespaces">change notifications</a>, it is possible to only subscribe
-for changes done in certain namespaces. At the SSE API, simply specify the <code class="highlighter-rouge">namespaces</code> parameter and provide a comma
+<p>As described in <a href="basic-changenotifications.html#by-namespaces">change notifications</a>, it is possible to subscribe only
+for changes done in specific namespaces. At the SSE API, simply specify the <code class="highlighter-rouge">namespaces</code> parameter and provide a comma
separated list of which namespaces to select, e.g.:</p>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>http://localhost:8080/api/<1|2>/things?namespaces=org.eclipse.ditto.one,org.eclipse.test
</code></pre></div></div>
@@ -1333,16 +1570,10 @@
<h3 id="example-for-sse-on-things">Example for SSE on Things</h3>
-<p>Assuming we have a Thing (in API version 1) with the following JSON content:</p>
+<p>Assuming we have a thing with the following JSON content:</p>
<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
</span><span class="s2">"thingId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto:fancy-thing"</span><span class="p">,</span><span class="w">
- </span><span class="s2">"acl"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
- </span><span class="s2">"{userId}"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
- </span><span class="s2">"READ"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="p">,</span><span class="w">
- </span><span class="s2">"WRITE"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="p">,</span><span class="w">
- </span><span class="s2">"ADMINISTRATE"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="w">
- </span><span class="p">}</span><span class="w">
- </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"policyId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto:fancy-thing"</span><span class="p">,</span><span class="w">
</span><span class="s2">"attributes"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
</span><span class="s2">"manufacturer"</span><span class="p">:</span><span class="w"> </span><span class="s2">"ACME corp"</span><span class="p">,</span><span class="w">
</span><span class="s2">"complex"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
@@ -1362,23 +1593,23 @@
</span></code></pre></div></div>
<p>From within JavaScript we can now create an <code class="highlighter-rouge">EventSource</code> in order to open up a SSE stream in Ditto and simply print each
-event to the console. This one tracks only changes to the Thing with ID <code class="highlighter-rouge">org.eclipse.ditto:fancy-thing</code> and only watches
+event to the console. This one tracks only changes to the thing with ID <code class="highlighter-rouge">org.eclipse.ditto:fancy-thing</code> and only watches
for changes on the feature <code class="highlighter-rouge">lamp</code>:</p>
<div class="language-javascript highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c1">// the javascript must be served from the same domain as Ditto is running in order to avoid CORS problems</span>
-<span class="kd">let</span> <span class="nx">source</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">EventSource</span><span class="p">(</span><span class="s1">'/api/1/things?ids=org.eclipse.ditto:fancy-thing&fields=thingId,features/lamp'</span><span class="p">);</span>
+<span class="kd">let</span> <span class="nx">source</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">EventSource</span><span class="p">(</span><span class="s1">'/api/2/things?ids=org.eclipse.ditto:fancy-thing&fields=thingId,features/lamp'</span><span class="p">);</span>
<span class="nx">source</span><span class="p">.</span><span class="nx">onmessage</span> <span class="o">=</span> <span class="kd">function</span> <span class="p">(</span><span class="nx">event</span><span class="p">)</span> <span class="p">{</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">event</span><span class="p">.</span><span class="nx">data</span><span class="p">);</span>
<span class="p">};</span>
</code></pre></div></div>
-<p>This would print for each <code class="highlighter-rouge">Thing</code> the authenticated user is allowed to <code class="highlighter-rouge">READ</code> (see <a href="basic-acl.html">acl</a>) the changed content of the Thing.</p>
+<p>This would log the changed content of each thing the authenticated subject is allowed to <code class="highlighter-rouge">READ</code>.</p>
<p>So when the <code class="highlighter-rouge">on</code> property of the <code class="highlighter-rouge">lamp</code> feature is changed to <code class="highlighter-rouge">true</code> via such an HTTP API call:</p>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>PUT /api/1/things/org.eclipse.ditto:fancy-thing/features/lamp/properties/on
payload: true
</code></pre></div></div>
-<p>The JavaScript snippet would log to console:</p>
+<p>the JavaScript snippet would log to console:</p>
<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
</span><span class="s2">"thingId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto:fancy-thing"</span><span class="p">,</span><span class="w">
</span><span class="s2">"features"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
@@ -1391,6 +1622,92 @@
</span><span class="p">}</span><span class="w">
</span></code></pre></div></div>
+<h2 id="sse-api-searchthings">SSE API <code class="highlighter-rouge">/search/things</code></h2>
+
+<p>The SSE API to stream search results is the <code class="highlighter-rouge">/search/things</code> endpoint:</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>http://localhost:8080/api/<1|2>/search/things
+</code></pre></div></div>
+
+<p>This is the second mechanism of Ditto in order to get <a href="basic-search.html">search results</a>.
+The benefits of this mechanism over the <a href="protocol-specification-things-search.html">search protocol</a> are:</p>
+<ul>
+ <li>The client side is easy to implement; it needs not abide by the reactive-streams rules.</li>
+ <li>SSE permits <a href="#resuming-by-last-event-id">resuming a stream from the last received ID</a> after connection interruptions.</li>
+</ul>
+
+<p>The drawback is, that SSE has no application-layer flow control and must rely on the transport layer (TCP) for
+back-pressure. In contrast, the <a href="protocol-specification-things-search.html">search protocol</a> supports back-pressure
+and cancellation over any transport layer by reactive-streams means.</p>
+
+<p>When the endpoint is invoked with an HTTP header <code class="highlighter-rouge">Accept</code> with value <code class="highlighter-rouge">text/event-stream</code>, a Server-Sent Event stream of
+things is created by Ditto and for each thing matching the search filter for which the caller has READ permissions
+(see <a href="basic-auth.html#authorization">authorization</a>), an event is sent to the client.</p>
+
+<p>The format of the event at the <code class="highlighter-rouge">/search/things</code> endpoint is always in the form of a <a href="basic-thing.html#model-specification">Thing JSON</a>
+(in API 1 format or API 2 format depending on which endpoint the SSE was created).</p>
+
+<h3 id="filtering-by-rql-expression-1">Filtering by RQL expression</h3>
+
+<p>Specify the <code class="highlighter-rouge">filter</code> parameter with an <a href="basic-rql.html">RQL expression</a> to restrict the search results to things
+matching the RQL expression. For example, the SSE stream below emits only things which have a <code class="highlighter-rouge">counter</code> attribute
+with value <code class="highlighter-rouge">42</code>:</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>http://localhost:8080/api/<1|2>/search/things?filter=eq(attributes/counter,42)
+</code></pre></div></div>
+
+<h3 id="filtering-by-namespaces-1">Filtering by namespaces</h3>
+
+<p>Specify the <code class="highlighter-rouge">namespaces</code> parameter to restrict search to the namespaces given as a comma separated list. For example:</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>http://localhost:8080/api/<1|2>/search/things?namespaces=org.eclipse.ditto.one,org.eclipse.test
+</code></pre></div></div>
+
+<h3 id="sorting-by-rql-sort-option">Sorting by RQL sort option</h3>
+
+<p>Specify the <code class="highlighter-rouge">option</code> parameter with an <a href="basic-rql.html#rql-sorting">RQL sort option</a> to stream things in a certain
+order. For example, the SSE stream below emits things according to the timestamp. The timestamp of their last updates
+is stored in the <code class="highlighter-rouge">_modified</code> field, and <code class="highlighter-rouge">-</code> describes the descending order, thus the thing with the newest
+changes appears first:</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>http://localhost:8080/api/<1|2>/search/things?option=sort(-_modified)
+</code></pre></div></div>
+
+<p><strong>Fields projection</strong></p>
+
+<p>Use the <code class="highlighter-rouge">fields</code> parameter to retrieve only specific parts of things in search results, e.g.:</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>http://localhost:8080/api/<1|2>/search/things?fields=thingId,attributes
+</code></pre></div></div>
+
+<h3 id="resuming-by-last-event-id">Resuming by <code class="highlighter-rouge">Last-Event-ID</code></h3>
+
+<p>The <a href="https://html.spec.whatwg.org/multipage/server-sent-events.html">HTML5 SSE specification</a>
+permits clients to resume from interrupted streams by sending a header <code class="highlighter-rouge">Last-Event-ID</code>.
+Each thing in the search result has its thing ID set as the event ID.
+To resume the stream from the point of its interruption,
+start another SSE stream with <em>identical</em> query parameters and the <code class="highlighter-rouge">Last-Event-ID</code> header set to the last received
+event ID.
+Specification-conform SSE clients perform resumption automatically, making SSE a simple way to export large numbers
+of things over a slow connection for long periods of time.</p>
+
+<p><strong>Example:</strong></p>
+
+<p>Request</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>GET http://localhost:8080/api/2/search/things?fields=thingId&option=sort(+thingId) HTTP/1.1
+Accept: text/event-stream
+Last-Event-ID: ditto:device7152
+</code></pre></div></div>
+
+<p>Response</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>HTTTP/1.1 200 OK
+Content-Type: text/event-stream
+
+data:{"thingId":"ditto:device7153"}
+id:ditto:device7153
+
+data:{"thingId":"ditto:device7154"}
+id:ditto:device7154
+
+data:{"thingId":"ditto:device7155"}
+id:ditto:device7155
+</code></pre></div></div>
+
<div class="tags">
@@ -1420,7 +1737,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/images/2020-04-16-Logo_TTVC_color.png b/1.0/images/2020-04-16-Logo_TTVC_color.png
new file mode 100755
index 0000000..aef387c
--- /dev/null
+++ b/1.0/images/2020-04-16-Logo_TTVC_color.png
Binary files differ
diff --git a/1.0/images/iot_logo.svg b/1.0/images/iot_logo.svg
new file mode 100755
index 0000000..e30be71
--- /dev/null
+++ b/1.0/images/iot_logo.svg
@@ -0,0 +1,52 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Generator: Adobe Illustrator 16.0.4, SVG Export Plug-In . SVG Version: 6.00 Build 0) -->
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" id="Calque_1" xmlns="http://www.w3.org/2000/svg" x="0px" y="0px"
+ width="102.625px" height="59.875px" viewBox="88.5 20.125 102.625 59.875"
+ enable-background="new 88.5 20.125 102.625 59.875"
+ xml:space="preserve">
+<g>
+ <g>
+ <rect id="XMLID_24_" x="110.269" y="30.56" fill="#37474F" width="7.03" height="7.785"/>
+ <path id="XMLID_23_" fill="#37474F" d="M123.3,72.137h-6.005V45.001c0-0.977-0.779-1.823-1.823-1.823h-7.3v7.289h1.898v21.666
+ h-5.763v7.221h25.202C126.823,77.587,124.659,75.084,123.3,72.137"/>
+ <path id="XMLID_22_" fill="#37474F" d="M190.651,50.471v-7.289h-12.626V30.56h-7.222v12.623H158.57
+ c2.701,1.788,4.877,4.31,6.24,7.289h5.993v14.445c0,7.939,6.507,14.446,14.446,14.446h5.401v-7.222h-5.401
+ c-3.969,0-7.225-3.256-7.225-7.225V50.471H190.651z"/>
+ <path id="XMLID_19_" fill="#37474F" d="M147.66,43.182h-7.221c-7.94,0-14.446,6.506-14.446,14.509v7.221
+ c0,7.939,6.506,14.446,14.446,14.446h5.112h2.109c7.939,0,14.445-6.507,14.445-14.446v-7.221
+ C162.105,49.688,155.596,43.182,147.66,43.182 M154.881,64.912c0,3.969-3.254,7.225-7.225,7.225h-7.217
+ c-3.972,0-7.221-3.256-7.221-7.225v-7.221c0-3.968,3.253-7.221,7.221-7.221h7.221c3.972,0,7.225,3.253,7.225,7.221v7.221H154.881z
+ "/>
+ </g>
+ <path id="XMLID_16_" fill="#F69322" d="M92.28,75.148c0-2.459,1.255-3.687,3.766-3.687c0.333,0,0.667,0.024,1,0.067v5.378
+ c1.144,0,1.712-0.838,1.712-2.515c0-0.817-0.075-1.636-0.23-2.454h1.62c0.155,0.716,0.23,1.585,0.23,2.606
+ c0,2.935-1.382,4.404-4.143,4.404C93.599,78.953,92.28,77.686,92.28,75.148z M95.628,76.908v-3.456h-0.063
+ c-1.12,0-1.68,0.563-1.68,1.696C93.884,76.229,94.468,76.816,95.628,76.908z"/>
+ <path id="XMLID_14_" fill="#F69322" d="M100.148,63.947c0.155,0.668,0.23,1.362,0.23,2.081c0,2.88-1.402,4.321-4.206,4.321
+ c-2.598,0-3.896-1.438-3.896-4.321c0-0.719,0.076-1.413,0.23-2.081h1.621c-0.155,0.668-0.23,1.311-0.23,1.93
+ c0,1.621,0.759,2.432,2.276,2.432c1.724,0,2.585-0.811,2.585-2.432c0-0.615-0.075-1.258-0.23-1.93H100.148z"/>
+ <path id="XMLID_12_" fill="#F69322" d="M89.349,60.555h11.03v2.046h-11.03V60.555z"/>
+ <path id="XMLID_9_" fill="#F69322" d="M89.349,56.58h1.621v2.045h-1.621V56.58z M92.28,56.58h8.099v2.045H92.28V56.58z"/>
+ <path id="XMLID_6_" fill="#F69322" d="M92.613,54.652c-0.222-1.076-0.33-2.211-0.33-3.407c0-2.752,1.283-4.127,3.849-4.127
+ c2.832,0,4.25,1.279,4.25,3.841c0,0.545-0.127,1.097-0.385,1.652h3.317v2.046H92.613V54.652z M98.266,52.607
+ c0.278-0.508,0.417-1.057,0.417-1.645c0-1.219-0.858-1.827-2.57-1.827c-1.454,0-2.181,0.675-2.181,2.022
+ c0,0.58,0.036,1.064,0.107,1.449H98.266z"/>
+ <path id="XMLID_4_" fill="#F69322" d="M99.993,45.573h-1.696c0.361-0.897,0.54-1.938,0.54-3.118c0-0.882-0.282-1.319-0.85-1.319
+ c-0.54,0-0.81,0.294-0.81,0.886v1.466c0,1.644-0.811,2.47-2.431,2.47c-1.696,0-2.546-1.199-2.546-3.603
+ c0-1.017,0.155-1.978,0.465-2.879h1.696c-0.362,0.901-0.541,1.878-0.541,2.931c0,1.104,0.282,1.66,0.85,1.66
+ c0.54,0,0.81-0.322,0.81-0.965v-1.311c0-1.799,0.811-2.701,2.431-2.701c1.696,0,2.546,1.148,2.546,3.439
+ C100.458,43.659,100.303,44.672,99.993,45.573z"/>
+ <path id="XMLID_1_" fill="#F69322" d="M92.28,34.246c0-2.458,1.255-3.686,3.766-3.686c0.333,0,0.667,0.024,1,0.067v5.378
+ c1.144,0,1.712-0.838,1.712-2.514c0-0.818-0.075-1.636-0.23-2.455h1.62c0.155,0.715,0.23,1.585,0.23,2.605
+ c0,2.936-1.382,4.405-4.143,4.405C93.599,38.051,92.28,36.784,92.28,34.246z M95.628,36.005V32.55h-0.063
+ c-1.12,0-1.68,0.564-1.68,1.696C93.884,35.326,94.468,35.914,95.628,36.005z"/>
+ <circle fill="#F69322" cx="157.652" cy="27.517" r="6.875"/>
+ <circle fill="#F69322" cx="140.832" cy="34.468" r="3.042"/>
+ <circle fill="#F69322" cx="132.396" cy="24.55" r="3.912"/>
+
+ <rect x="136.492" y="22.837" transform="matrix(-0.7659 0.643 -0.643 -0.7659 261.5014 -34.9057)" fill="#F69322" width="1.227" height="14.633"/>
+
+ <rect x="141.079" y="30.375" transform="matrix(-0.9158 0.4017 -0.4017 -0.9158 299.3018 -0.7774)" fill="#F69322" width="17.306" height="1.227"/>
+</g>
+</svg>
diff --git a/1.0/images/pages/architecture/context-overview.png b/1.0/images/pages/architecture/context-overview.png
index b560ccf..86023bd 100755
--- a/1.0/images/pages/architecture/context-overview.png
+++ b/1.0/images/pages/architecture/context-overview.png
Binary files differ
diff --git a/1.0/index.html b/1.0/index.html
index 6579219..05f1f66 100644
--- a/1.0/index.html
+++ b/1.0/index.html
@@ -264,7 +264,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/installation-building.html b/1.0/installation-building.html
index d7308d2..789bf2e 100644
--- a/1.0/installation-building.html
+++ b/1.0/installation-building.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1252,16 +1473,14 @@
<p>In order to build Ditto with Maven, you’ll need:</p>
<ul>
- <li>JDK 8 >= 1.8.0_92 (due to a bug in older versions of the JDK you’ll get a compile error),</li>
+ <li>JDK 11 >= 1.0.5,</li>
<li>Apache Maven 3.x installed,</li>
<li>a running Docker daemon (at least version 18.06 CE).</li>
</ul>
-<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c"># if you have the Docker daemon running with remote access enabled (e.g. in a Vagrant box or on localhost):</span>
-mvn clean install <span class="nt">-Pdocker-build-image</span> <span class="nt">-Ddocker</span>.daemon.hostname<span class="o">=</span><ip/host of your Docker daemon>
-
-<span class="c"># if you have the Docker daemon running on your machine and you are running on Unix, you can also connect against the Docker socket:</span>
-mvn clean install <span class="nt">-Pdocker-build-image</span> <span class="nt">-Ddocker</span>.daemon.url<span class="o">=</span>unix:///var/run/docker.sock
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>mvn clean install
+<span class="nb">cd </span>services
+sh build-images.sh
</code></pre></div></div>
<h2 id="building-with-docker">Building with Docker</h2>
@@ -1269,22 +1488,16 @@
<p>In order to build Ditto with Docker, you’ll need a running Docker daemon (at least version 18.06 CE).</p>
<p>If you do not have the appropriate Maven and JDK version available, you can also use a Maven Docker image as build
-environment.
-On a Linux or macOS host you can expose the Docker socket to Maven like this:</p>
+environment.</p>
-<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c"># Start up the Docker image with maven:</span>
-docker run <span class="nt">-it</span> <span class="nt">--rm</span> <span class="nt">--name</span> mvn-ditto <span class="se">\</span>
- <span class="nt">-v</span> /var/run/docker.sock:/var/run/docker.sock <span class="se">\</span>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>docker run <span class="nt">-it</span> <span class="nt">--rm</span> <span class="nt">--name</span> mvn-ditto <span class="se">\</span>
<span class="nt">-v</span> <span class="s2">"</span><span class="nv">$PWD</span><span class="s2">"</span>:/usr/src/mymaven <span class="nt">-w</span> /usr/src/mymaven <span class="se">\</span>
<span class="nt">-u</span> root <span class="se">\</span>
- maven:3.5.0-jdk-8 <span class="se">\</span>
- /bin/bash
+ maven:3.6-jdk-11 <span class="se">\</span>
+ mvn clean install
-<span class="c"># From within the Docker image, build the Docker images:</span>
-mvn clean install <span class="nt">-Pdocker-build-image</span> <span class="se">\</span>
- <span class="nt">-Ddocker</span>.daemon.url<span class="o">=</span>unix:///var/run/docker.sock
-
-<span class="c"># Docker images are now available on your Docker host</span>
+<span class="nb">cd </span>services
+sh build-images.sh
</code></pre></div></div>
@@ -1317,7 +1530,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/installation-operating.html b/1.0/installation-operating.html
index e8891d8..76157d6 100644
--- a/1.0/installation-operating.html
+++ b/1.0/installation-operating.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1286,6 +1507,31 @@
<p>The executable for the microservice is called <code class="highlighter-rouge">starter.jar</code>. The configuration variables have to be set before
the <code class="highlighter-rouge">-jar</code> option.</p>
+<h3 id="pre-authentication">Pre-authentication</h3>
+
+<p>HTTP API calls to Ditto may be authenticated with a reverse proxy (e.g. a nginx) which:</p>
+<ul>
+ <li>authenticates a user/subject</li>
+ <li>passes the authenticated username as HTTP header</li>
+ <li>ensures that this HTTP header can never be written by the end-user</li>
+</ul>
+
+<p>By default, <code class="highlighter-rouge">pre-authentication</code> is <strong>disabled</strong> in the Ditto <a href="architecture-services-gateway.html">gateway</a> services.<br />
+It can however be enabled by configuring the environment variable <code class="highlighter-rouge">ENABLE_PRE_AUTHENTICATION</code> to the value <code class="highlighter-rouge">true</code>.</p>
+
+<p>When it is enabled, the reverse proxy has to set the HTTP header <code class="highlighter-rouge">x-ditto-pre-authenticated</code>.<br />
+The format of the “pre-authenticated” string is: <code class="highlighter-rouge"><issuer>:<subject></code>. The issuer defines which system authenticated the
+user and the subject contains e.g. the user-id or -name.</p>
+
+<p>This string must then be used in <a href="basic-policy.html#who-can-be-addressed">policies</a> as “Subject ID”.</p>
+
+<p>Example for a nginx “proxy” configuration:</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>auth_basic "Authentication required";
+auth_basic_user_file nginx.htpasswd;
+...
+proxy_set_header x-ditto-pre-authenticated "nginx:${remote_user}";
+</code></pre></div></div>
+
<h3 id="openid-connect">OpenID Connect</h3>
<p>The authentication provider must be added to the ditto-gateway configuration.</p>
@@ -1443,6 +1689,8 @@
<li>Piggyback commands</li>
</ul>
+<div class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> The default credentials for the <code class="highlighter-rouge">/devops</code> HTTP endpoint are username: <code class="highlighter-rouge">devops</code>, password: <code class="highlighter-rouge">foobar</code>. The password can be changed by setting the environment variable <code class="highlighter-rouge">DEVOPS_PASSWORD</code> in the gateway service.</div>
+
<h3 id="dynamically-adjust-log-levels">Dynamically adjust log levels</h3>
<p>Changing the log levels dynamically is very useful when debugging an accidental problem,
@@ -1669,16 +1917,17 @@
<p>Each command is sent to the actor selection <code class="highlighter-rouge">/user/conciergeRoot/eventSnapshotCleanupCoordinatorProxy</code> on <em>one</em>
Concierge instance, typically <code class="highlighter-rouge">INSTANCE_INDEX=1</code> in a docker-based installation:</p>
-<p><code class="highlighter-rouge">POST /devops/piggygack/concierge/<INSTANCE_INDEX>?timeout=10000</code></p>
+<p><code class="highlighter-rouge">POST /devops/piggygack/concierge/<INSTANCE_INDEX>?timeout=10s</code></p>
<h5 id="query-background-cleanup-coordinator-state">Query background cleanup coordinator state</h5>
-<p><code class="highlighter-rouge">POST /devops/piggygack/concierge/<INSTANCE_INDEX>?timeout=10000</code></p>
+<p><code class="highlighter-rouge">POST /devops/piggygack/concierge/<INSTANCE_INDEX>?timeout=10s</code></p>
<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
</span><span class="s2">"targetActorSelection"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/user/conciergeRoot/eventSnapshotCleanupCoordinatorProxy"</span><span class="p">,</span><span class="w">
</span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
- </span><span class="s2">"aggregate"</span><span class="p">:</span><span class="w"> </span><span class="kc">false</span><span class="w">
+ </span><span class="s2">"aggregate"</span><span class="p">:</span><span class="w"> </span><span class="kc">false</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"is-grouped-topic"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="w">
</span><span class="p">},</span><span class="w">
</span><span class="s2">"piggybackCommand"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
</span><span class="s2">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"status.commands:retrieveHealth"</span><span class="w">
@@ -1726,12 +1975,13 @@
<h5 id="query-background-cleanup-coordinator-configuration">Query background cleanup coordinator configuration</h5>
-<p><code class="highlighter-rouge">POST /devops/piggygack/concierge/<INSTANCE_INDEX>?timeout=10000</code></p>
+<p><code class="highlighter-rouge">POST /devops/piggygack/concierge/<INSTANCE_INDEX>?timeout=10s</code></p>
<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
</span><span class="s2">"targetActorSelection"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/user/conciergeRoot/eventSnapshotCleanupCoordinatorProxy"</span><span class="p">,</span><span class="w">
</span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
- </span><span class="s2">"aggregate"</span><span class="p">:</span><span class="w"> </span><span class="kc">false</span><span class="w">
+ </span><span class="s2">"aggregate"</span><span class="p">:</span><span class="w"> </span><span class="kc">false</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"is-grouped-topic"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="w">
</span><span class="p">},</span><span class="w">
</span><span class="s2">"piggybackCommand"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
</span><span class="s2">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"common.commands:retrieveConfig"</span><span class="w">
@@ -1778,12 +2028,13 @@
coordinator. All subsequent cleanup processes will use the new configuration. Any ongoing cleanup is not affected.
Configurations absent in the payload of the piggyback command remain unchanged.</p>
-<p><code class="highlighter-rouge">POST /devops/piggygack/concierge/<INSTANCE_INDEX>?timeout=10000</code></p>
+<p><code class="highlighter-rouge">POST /devops/piggygack/concierge/<INSTANCE_INDEX>?timeout=10s</code></p>
<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
</span><span class="s2">"targetActorSelection"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/user/conciergeRoot/eventSnapshotCleanupCoordinatorProxy"</span><span class="p">,</span><span class="w">
</span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
- </span><span class="s2">"aggregate"</span><span class="p">:</span><span class="w"> </span><span class="kc">false</span><span class="w">
+ </span><span class="s2">"aggregate"</span><span class="p">:</span><span class="w"> </span><span class="kc">false</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"is-grouped-topic"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="w">
</span><span class="p">},</span><span class="w">
</span><span class="s2">"piggybackCommand"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
</span><span class="s2">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"common.commands:modifyConfig"</span><span class="p">,</span><span class="w">
@@ -1833,12 +2084,13 @@
<p>Send a piggyback command of type <code class="highlighter-rouge">common.commands:shutdown</code> to stop the background cleanup process.
The next process is scheduled after the <code class="highlighter-rouge">quiet-period</code> duration in the coordinator’s configuration.</p>
-<p><code class="highlighter-rouge">POST /devops/piggygack/concierge/<INSTANCE_INDEX>?timeout=10000</code></p>
+<p><code class="highlighter-rouge">POST /devops/piggygack/concierge/<INSTANCE_INDEX>?timeout=10s</code></p>
<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
</span><span class="s2">"targetActorSelection"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/user/conciergeRoot/eventSnapshotCleanupCoordinatorProxy"</span><span class="p">,</span><span class="w">
</span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
- </span><span class="s2">"aggregate"</span><span class="p">:</span><span class="w"> </span><span class="kc">false</span><span class="w">
+ </span><span class="s2">"aggregate"</span><span class="p">:</span><span class="w"> </span><span class="kc">false</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"is-grouped-topic"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="w">
</span><span class="p">},</span><span class="w">
</span><span class="s2">"piggybackCommand"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
</span><span class="s2">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"common.commands:shutdown"</span><span class="w">
@@ -1865,7 +2117,7 @@
snapshots manually. Here is an example for things. Change the service name and shard region name accordingly for
policies and connections. Typically in a docker based environment, use <code class="highlighter-rouge">INSTANCE_INDEX=1</code>.</p>
-<p><code class="highlighter-rouge">POST /devops/piggygack/things/<INSTANCE_INDEX>?timeout=10000</code></p>
+<p><code class="highlighter-rouge">POST /devops/piggygack/things/<INSTANCE_INDEX>?timeout=10s</code></p>
<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
</span><span class="s2">"targetActorSelection"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/system/sharding/thing"</span><span class="p">,</span><span class="w">
@@ -1892,6 +2144,60 @@
</span><span class="p">}</span><span class="w">
</span></code></pre></div></div>
+<h4 id="managing-background-synchronization">Managing background synchronization</h4>
+
+<p>A background sync actor goes over thing snapshots and search index entries slowly to ensure eventual consistency
+of the search index. The actor operates in the same manner as the background cleanup coordinator and responds to
+the same commands.</p>
+
+<p><code class="highlighter-rouge">POST /devops/piggygack/things-search/<INSTANCE_INDEX>?timeout=10s</code></p>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"targetActorSelection"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/user/thingsSearchRoot/searchUpdaterRoot/backgroundSyncProxy"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"aggregate"</span><span class="p">:</span><span class="w"> </span><span class="kc">false</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"is-grouped-topic"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"piggybackCommand"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<COMMAND-TYPE>"</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<p><code class="highlighter-rouge">COMMAND-TYPE</code> can be:</p>
+<ul>
+ <li><code class="highlighter-rouge">common.commands:shutdown</code> to shutdown or restart a background sync stream,</li>
+ <li><code class="highlighter-rouge">common.commands:retrieveConfig</code> to retrieve the current configuration,</li>
+ <li><code class="highlighter-rouge">common.commands:modifyConfig</code> to modify the current configuration, or</li>
+ <li><code class="highlighter-rouge">status.commands:retrieveHealth</code> to query the current progress and event log.</li>
+</ul>
+
+<p>For each command type, please refer to the corresponding segment of “Managing background cleanup” for the exact format.</p>
+
+<h4 id="force-search-index-update-for-one-thing">Force search index update for one thing</h4>
+
+<p>The search index should rarely become out-of-sync for a long time, and it can repair itself
+of any inconsistencies detected at query time. Nevertheless, you can trigger search index update
+for a particular thing by a DevOp-command and bring the entry up-to-date immediately.</p>
+
+<p><code class="highlighter-rouge">POST /devops/piggygack/things-search/<INSTANCE_INDEX>?timeout=0</code></p>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"targetActorSelection"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/user/thingsSearchRoot/searchUpdaterRoot/thingsUpdater"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"aggregate"</span><span class="p">:</span><span class="w"> </span><span class="kc">false</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"is-grouped-topic"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"piggybackCommand"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"thing-search.commands:updateThing"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"thingId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<THING-ID>"</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<p>There is no response. Things-search service will log a warning upon receiving this message
+and continue to log warnings should the search index update fail on the persistence.</p>
+
<h4 id="erasing-data-within-a-namespace">Erasing data within a namespace</h4>
<p>Ditto supports erasure of <em>all</em> data within a namespace during live operations.
@@ -1912,7 +2218,7 @@
<p>Send a piggyback command to <a href="https://doc.akka.io/docs/akka/current/distributed-pub-sub.html">Akka’s pub-sub-mediator</a> with type <code class="highlighter-rouge">namespaces.commands:blockNamespace</code>
to block all messages sent to actors belonging to a namespace.</p>
-<p><code class="highlighter-rouge">PUT /devops/piggygack?timeout=10000</code></p>
+<p><code class="highlighter-rouge">PUT /devops/piggygack?timeout=10s</code></p>
<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
</span><span class="s2">"targetActorSelection"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/system/distributedPubSubMediator"</span><span class="p">,</span><span class="w">
@@ -1978,7 +2284,7 @@
<p>The erasure may take a long time if the namespace has a lot of data associated with it or if the persistent storage is
slow. Set the timeout to a safe margin above the estimated erasure time in milliseconds.</p>
-<p><code class="highlighter-rouge">PUT /devops/piggygack?timeout=10000</code></p>
+<p><code class="highlighter-rouge">PUT /devops/piggygack?timeout=10s</code></p>
<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
</span><span class="s2">"targetActorSelection"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/system/distributedPubSubMediator"</span><span class="p">,</span><span class="w">
@@ -2027,7 +2333,7 @@
<p>Send a piggyback command to <a href="https://doc.akka.io/docs/akka/current/distributed-pub-sub.html">Akka’s pub-sub-mediator</a> with type <code class="highlighter-rouge">namespaces.commands:unblockNamespace</code>
to stop blocking messages to a namespace.</p>
-<p><code class="highlighter-rouge">PUT /devops/piggygack?timeout=10000</code></p>
+<p><code class="highlighter-rouge">PUT /devops/piggygack?timeout=10s</code></p>
<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
</span><span class="s2">"targetActorSelection"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/system/distributedPubSubMediator"</span><span class="p">,</span><span class="w">
@@ -2080,7 +2386,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/installation-running.html b/1.0/installation-running.html
index 1c19e01..4b5202b 100644
--- a/1.0/installation-running.html
+++ b/1.0/installation-running.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1337,7 +1558,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/intro-digitaltwins.html b/1.0/intro-digitaltwins.html
index 512d73c..e842da3 100644
--- a/1.0/intro-digitaltwins.html
+++ b/1.0/intro-digitaltwins.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1312,7 +1533,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/intro-hello-world.html b/1.0/intro-hello-world.html
index 466cd6c..99c84e4 100644
--- a/1.0/intro-hello-world.html
+++ b/1.0/intro-hello-world.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1401,7 +1622,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/intro-overview.html b/1.0/intro-overview.html
index 0db0d45..5e39220 100644
--- a/1.0/intro-overview.html
+++ b/1.0/intro-overview.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1328,7 +1549,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/jsonschema/connection.json b/1.0/jsonschema/connection.json
index 3e409ad..81bd8ed 100644
--- a/1.0/jsonschema/connection.json
+++ b/1.0/jsonschema/connection.json
@@ -24,7 +24,7 @@
"connectionType": {
"$id": "/properties/connectionType",
"type": "string",
- "enum": [ "amqp-091", "amqp-10", "mqtt", "kafka", "http-push" ],
+ "enum": [ "amqp-091", "amqp-10", "mqtt", "mqtt-5", "kafka", "http-push" ],
"title": "Connection type",
"description": "The type determining the connection's underlying transport protocol",
"examples": [
@@ -266,12 +266,15 @@
"_/_/things/twin/events",
"_/_/things/twin/events?namespaces=org.eclipse.ditto.one,org.eclipse.foo",
"_/_/things/twin/events?namespaces=org.eclipse.ditto&filter=eq(attributes/counter,42)",
+ "_/_/things/twin/events?extraFields=attributes",
+ "_/_/things/twin/events?extraFields=attributes&filter=eq(attributes/counter,42)",
"_/_/things/live/commands",
"_/_/things/live/commands?namespaces=org.eclipse.ditto.one",
"_/_/things/live/events",
"_/_/things/live/events?filter=eq(attributes/counter,42)",
"_/_/things/live/messages",
- "_/_/things/live/messages?namespaces=org.eclipse.ditto"
+ "_/_/things/live/messages?namespaces=org.eclipse.ditto",
+ "_/_/things/live/messages?extraFields=attributes/tags,attributes/location"
]
}
},
diff --git a/1.0/jsonschema/policy.json b/1.0/jsonschema/policy.json
new file mode 100644
index 0000000..045ef64
--- /dev/null
+++ b/1.0/jsonschema/policy.json
@@ -0,0 +1,77 @@
+{
+ "$schema": "http://json-schema.org/draft-04/schema#",
+ "type": "object",
+ "description": "A Policy enables developers to configure fine-grained access control for Things.",
+ "title": "Policy",
+ "properties": {
+ "policyId": {
+ "type": "string",
+ "description": "Unique identifier representing the Policy, has to conform to the namespaced entity ID notation (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).\n\nExamples for a valid Policy ID:\n * `org.eclipse.ditto:xdk_policy_53`\n * `foo:xdk_53`\n * `org.eclipse.vorto_42:xdk_policy`"
+ },
+ "entries": {
+ "title": "PolicyEntries",
+ "type": "object",
+ "description": "PolicyEntries containing one PolicyEntry for each arbitrary `label` key.",
+ "properties": {
+ "additionalProperties": {
+ "title": "Label",
+ "type": "object",
+ "description": "Single Policy entry containing Subjects and Resources.",
+ "properties": {
+ "subjects": {
+ "title": "Subjects",
+ "type": "object",
+ "description": "Subjects defining who is addressed.",
+ "additionalProperties": {
+ "title": "SubjectEntry",
+ "type": "object",
+ "description": "Single (Authorization) Subject entry holding its type. The key is the actual subject identifier.",
+ "properties": {
+ "type": {
+ "type": "string",
+ "title": "SubjectType",
+ "description": "The type of the (Authorization) Subject. See [Policy documentation](../basic-policy.html#who-can-be-addressed) for allowed values."
+ }
+ }
+ }
+ },
+ "resources": {
+ "title": "Resources",
+ "type": "object",
+ "description": "Resources containing one or many ResourceEntries.",
+ "additionalProperties": {
+ "title": "ResourceEntry",
+ "type": "object",
+ "description": "Single Resource entry defining permissions per effect. The keys must be in the format `type:path` with `type` being one of the following `thing`, `policy` or `message` resources. See [Policy documentation](../basic-policy.html#which-resources-can-be-controlled) for detailed information.",
+ "properties": {
+ "grant": {
+ "type": "array",
+ "items": {
+ "type": "string",
+ "description": "All subjects specified in this Policy entry are granted read/write permission on the resources specified in the path, and all subsequent paths, except they are revoked at a subsequent policy label.",
+ "enum": [
+ "READ",
+ "WRITE"
+ ]
+ }
+ },
+ "revoke": {
+ "type": "array",
+ "items": {
+ "type": "string",
+ "description": "All subjects specified in this Policy entry are prohibited to read/write on the resources specified in the path, and all subsequent paths, except they are granted again such permission at a subsequent policy label.",
+ "enum": [
+ "READ",
+ "WRITE"
+ ]
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+}
diff --git a/1.0/jsonschema/protocol-ack.json b/1.0/jsonschema/protocol-ack.json
new file mode 100644
index 0000000..21b1aed
--- /dev/null
+++ b/1.0/jsonschema/protocol-ack.json
@@ -0,0 +1,42 @@
+{
+ "$schema": "http://json-schema.org/draft-04/schema#",
+ "type": "object",
+ "description": "An Ditto Protocol ACK/NACK is sent in response to an event.",
+ "title": "Ditto Protocol acknowledgement",
+ "properties": {
+ "topic": {
+ "type": "string",
+ "description": "Contains the topic of the acknowledgement, ending with the acknowledgement label."
+ },
+ "headers": {
+ "type": "object",
+ "description": "Additional headers.",
+ "properties": {
+ "correlation-id": {
+ "type": "string",
+ "description": "The correlation-id header is used for linking the acknowledgement to the event which requested it."
+ },
+ "version": {
+ "type": "integer",
+ "description": "Determines the schema version of the payload.",
+ "minimum": 1,
+ "maximum": 2
+ }
+ },
+ "required": [ "correlation-id" ]
+ },
+ "path": {
+ "type": "string",
+ "description": "The path is always the empty path `/` for an acknowledgement."
+ },
+ "value": {
+ "type": ["object","string","number","array","boolean"],
+ "description": "The _value_ field contains the optional payload of the acknowledgement."
+ },
+ "status": {
+ "type": "integer",
+ "description": "The status code that indicates the result of the acknowledgement. The semantics of the used status codes are based on the [HTTP status codes](https://tools.ietf.org/html/rfc7231#section-6)."
+ }
+ },
+ "required": [ "topic", "headers", "path", "status" ]
+}
diff --git a/1.0/jsonschema/protocol-acks.json b/1.0/jsonschema/protocol-acks.json
new file mode 100644
index 0000000..86b3b7c
--- /dev/null
+++ b/1.0/jsonschema/protocol-acks.json
@@ -0,0 +1,42 @@
+{
+ "$schema": "http://json-schema.org/draft-04/schema#",
+ "type": "object",
+ "description": "An Ditto Protocol acknowledgement (ACK) aggregating message containing several single ACKs.",
+ "title": "Ditto Protocol acknowledgements",
+ "properties": {
+ "topic": {
+ "type": "string",
+ "description": "Contains the topic of the acknowledgements."
+ },
+ "headers": {
+ "type": "object",
+ "description": "Additional headers.",
+ "properties": {
+ "correlation-id": {
+ "type": "string",
+ "description": "The correlation-id header is used for linking the acknowledgements to the event which requested it."
+ },
+ "version": {
+ "type": "integer",
+ "description": "Determines the schema version of the payload.",
+ "minimum": 1,
+ "maximum": 2
+ }
+ },
+ "required": [ "correlation-id" ]
+ },
+ "path": {
+ "type": "string",
+ "description": "The path is always the empty path `/` for acknowledgements."
+ },
+ "value": {
+ "type": "object",
+ "description": "The _value_ field contains the payload of the acknowledgements which consists of all included single acknowledgements with their label as JSON key and as value their JSON represenataion as JSON object."
+ },
+ "status": {
+ "type": "integer",
+ "description": "The status code that indicates the aggregated/overall status of the combined acknowledgements.\nWhen all contained acknowledgements were successfull (2xx), this status is 200 (OK).\nWhen at least one was not successful, the status is 424 (failed dependency) meaning that the contained status codes have to be looked at separately."
+ }
+ },
+ "required": [ "topic", "headers", "path", "status" ]
+}
diff --git a/1.0/jsonschema/protocol-envelope.json b/1.0/jsonschema/protocol-envelope.json
index c3b4288..94d6dfa 100644
--- a/1.0/jsonschema/protocol-envelope.json
+++ b/1.0/jsonschema/protocol-envelope.json
@@ -12,23 +12,55 @@
"type": "object",
"description": "Additional headers.",
"properties": {
+ "content-type": {
+ "type": "string",
+ "description": "The content-type of the message, for Ditto Protocol messages: `application/vnd.eclipse.ditto+json`."
+ },
"correlation-id": {
"type": "string",
"description": "The correlation-id header is used for linking one message with another. It typically links a reply message with its requesting message."
},
+ "ditto-originator": {
+ "type": "string",
+ "description": "Contains the first authorization subject of the command that caused the sending of this message. Set by Ditto."
+ },
+ "If-Match": {
+ "type": "string",
+ "description": "The `If-Match` header which has to conform to RFC-7232 (Conditional Requests). Common usages are:\n * optimistic locking by specifying the `ETag` from a previous response, e.g. `If-Match: \"hash:a75ece4e\"`\n * retrieving or modifying a resource only if it already exists, e.g. `If-Match: *`"
+ },
+ "If-None-Match": {
+ "type": "string",
+ "description": "The `If-None-Match` header which has to conform to RFC-7232 (Conditional Requests)."
+ },
"response-required": {
"type": "boolean",
"description": "Whether a response to a command is required or if it may be omitted (fire and forget semantics)."
},
+ "requested-acks": {
+ "description": "Defining which acknowledgements (\"ack\") are requested for a command processed by Ditto.",
+ "type": "array",
+ "uniqueItems": true,
+ "items": {
+ "type": "string",
+ "description": "A single acknowledgement label containing at least 3 characters.",
+ "pattern": "[a-zA-Z0-9-_]{3,64}"
+ }
+ },
+ "timeout": {
+ "type": "string",
+ "description": "The timeout value to apply on the Ditto server side, e.g. applied when waiting for requested acknowledgements. Examples:\n * `42s`\n * `250ms`\n * `1m`\n * `60` (interpreted as seconds)",
+ "examples": [
+ "42s",
+ "250ms",
+ "1m",
+ "60"
+ ]
+ },
"version": {
"type": "integer",
- "description": "Determines the version of the *Things* payload.",
+ "description": "Determines the schema version of the payload.",
"minimum": 1,
"maximum": 2
- },
- "source": {
- "type": "string",
- "description": "The source which initiated the command, e.g. a _clientId_."
}
},
"required": [ "correlation-id" ]
@@ -44,6 +76,10 @@
"value": {
"type": ["object","string","number","array","boolean"],
"description": "The `value` field contains the actual payload e.g. a sensor value."
+ },
+ "extra": {
+ "type": "object",
+ "description": "The `extra` object contains the `extraFields` which have optionally been selected to additionally be included."
}
},
"required": [ "topic", "headers", "path", "value" ]
diff --git a/1.0/jsonschema/protocol-search-failed-payload.json b/1.0/jsonschema/protocol-search-failed-payload.json
new file mode 100644
index 0000000..39ef16d
--- /dev/null
+++ b/1.0/jsonschema/protocol-search-failed-payload.json
@@ -0,0 +1,35 @@
+{
+ "$schema": "http://json-schema.org/draft-04/schema#",
+ "type": "object",
+ "description": "",
+ "title": "",
+ "properties": {
+ "subscriptionId": {
+ "type": "string",
+ "description": "Identifier of the search subscription delivered by a previous \"created\" event."
+ },
+ "error": {
+ "type": "object",
+ "description": "The _error_ field contains information about the error that occurred.",
+ "properties": {
+ "status": {
+ "type": "integer",
+ "description": "The status code that indicates the cause of the error. The semantics of the used status codes are based on the [HTTP status codes](https://tools.ietf.org/html/rfc7231#section-6)."
+ },
+ "error": {
+ "type": "string",
+ "description": "The error code that uniquely identifies the error, e.g., <br/>`thing-search:subscription.protocol.error`."
+ },
+ "message": {
+ "type": "string",
+ "description": "A human readable message that explains in detail what went wrong."
+ },
+ "description": {
+ "type": "string",
+ "description": "Contains further information about the error e.g. a hint what caused the problem and how to solve it."
+ }
+ }
+ }
+ },
+ "required": ["subscriptionId", "error"]
+}
diff --git a/1.0/jsonschema/protocol-search-next-payload.json b/1.0/jsonschema/protocol-search-next-payload.json
new file mode 100644
index 0000000..542be23
--- /dev/null
+++ b/1.0/jsonschema/protocol-search-next-payload.json
@@ -0,0 +1,17 @@
+{
+ "$schema": "http://json-schema.org/draft-04/schema#",
+ "type": "object",
+ "description": "",
+ "title": "",
+ "properties": {
+ "subscriptionId": {
+ "type": "string",
+ "description": "Identifier of the search subscription delivered by a previous \"created\" event."
+ },
+ "items": {
+ "type": "array",
+ "description": "A JSON array containing JSON representations of things in this page of the search results."
+ }
+ },
+ "required": ["subscriptionId", "items"]
+}
diff --git a/1.0/jsonschema/protocol-search-request-payload.json b/1.0/jsonschema/protocol-search-request-payload.json
new file mode 100644
index 0000000..a87f7fe
--- /dev/null
+++ b/1.0/jsonschema/protocol-search-request-payload.json
@@ -0,0 +1,17 @@
+{
+ "$schema": "http://json-schema.org/draft-04/schema#",
+ "type": "object",
+ "description": "",
+ "title": "",
+ "properties": {
+ "subscriptionId": {
+ "type": "string",
+ "description": "Identifier of the search subscription delivered by a previous \"created\" event."
+ },
+ "demand": {
+ "type": "number",
+ "description": "How many pages to request. Must be a positive integer."
+ }
+ },
+ "required": ["subscriptionId", "demand"]
+}
diff --git a/1.0/jsonschema/protocol-search-subscribe-payload.json b/1.0/jsonschema/protocol-search-subscribe-payload.json
new file mode 100644
index 0000000..51ea62f
--- /dev/null
+++ b/1.0/jsonschema/protocol-search-subscribe-payload.json
@@ -0,0 +1,25 @@
+{
+ "$schema": "http://json-schema.org/draft-04/schema#",
+ "type": "object",
+ "description": "",
+ "title": "",
+ "properties": {
+ "filter": {
+ "type": "string",
+ "description": "[RQL filter expression](https://www.eclipse.org/ditto/basic-rql.html#rql-filter) to select for things."
+ },
+ "options": {
+ "type": "string",
+ "description": "Specify the page size with `size(PAGE_SIZE)`, or the order of the search results by `sort(<+|-><property>)` (see [RQL sorting](https://www.eclipse.org/ditto/basic-rql.html#rql-sorting)).",
+ "examples": ["size(25)", "sort(+_modified,-thingId)"]
+ },
+ "namespaces": {
+ "type": "array",
+ "items": {
+ "type": "string"
+ },
+ "description": "Specify the namespaces to search in, or leave out to search in all namespaces.",
+ "examples": [["org.eclipse.ditto", "com.acme"]]
+ }
+ }
+}
diff --git a/1.0/jsonschema/protocol-search-subscriptionid.json b/1.0/jsonschema/protocol-search-subscriptionid.json
new file mode 100644
index 0000000..490bea7
--- /dev/null
+++ b/1.0/jsonschema/protocol-search-subscriptionid.json
@@ -0,0 +1,13 @@
+{
+ "$schema": "http://json-schema.org/draft-04/schema#",
+ "type": "object",
+ "description": "",
+ "title": "",
+ "properties": {
+ "subscriptionId": {
+ "type": "string",
+ "description": "Identifier of the search subscription delivered by a previous \"created\" event."
+ }
+ },
+ "required": ["subscriptionId"]
+}
diff --git a/1.0/openapi/ditto-api-1.yml b/1.0/openapi/ditto-api-1.yml
index 375e783..900ea45 100644
--- a/1.0/openapi/ditto-api-1.yml
+++ b/1.0/openapi/ditto-api-1.yml
@@ -10,7 +10,7 @@
# SPDX-License-Identifier: EPL-2.0
openapi: 3.0.0
info:
- title: Eclipse Ditto HTTP API
+ title: Eclipse Ditto HTTP API - Deprecated
description: JSON-based, REST-like API for Eclipse Ditto
version: "1"
servers:
@@ -42,6 +42,7 @@
Optionally you can use field selectors (see parameter `fields`) to only get the specified fields.
To retrieve all Things the logged in user is allowed to read, please use the `GET /search/things` operation.
+ deprecated: true
tags:
- Things
parameters:
@@ -86,6 +87,7 @@
entry with `READ`, `WRITE` and `ADMINISTRATE` permissions set to `true`.
If no ACL is provided, a default ACL with an entry for the authorized subject with all permissions set to
`true` will be created.
+ deprecated: true
tags:
- Things
responses:
@@ -142,6 +144,7 @@
Returns the Thing identified by the `thingId` path parameter.
The response includes all details about the Thing.
Optionally you can use field selectors (see parameter `fields`) to only get the specified fields.
+ deprecated: true
tags:
- Things
parameters:
@@ -272,6 +275,7 @@
}
```
+ deprecated: true
tags:
- Things
parameters:
@@ -350,6 +354,7 @@
summary: Delete a specific Thing
description: |-
Deletes the Thing identified by the `thingId` path parameter.
+ deprecated: true
tags:
- Things
parameters:
@@ -393,11 +398,12 @@
description: |-
Returns the Access Control List (ACL) of the Thing identified by the `thingId` path parameter.
The response contains the ACL as JSON object containing a key for each subject having ACL permissions.
+ deprecated: true
tags:
- Things
parameters:
- $ref: '#/components/parameters/thingIdPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
responses:
'200':
@@ -457,11 +463,12 @@
Modify the complete Access Control List (ACL) of the Thing identified by the `thingId` path parameter.
The ACL must include at least one entry with `READ`, `WRITE` and `ADMINISTRATE` permissions set to `true`.
+ deprecated: true
tags:
- Things
parameters:
- $ref: '#/components/parameters/thingIdPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
responses:
'204':
@@ -531,12 +538,13 @@
description: |-
Returns one Access Control List (ACL) entry of the Thing identified by the `thingId` path parameter and for the subject
identified by the `authorizationSubject` path parameter.
+ deprecated: true
tags:
- Things
parameters:
- $ref: '#/components/parameters/thingIdPathParam'
- $ref: '#/components/parameters/authorizationSubjectPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
responses:
'200':
@@ -584,12 +592,13 @@
An ACL entry must contain values for `READ`, `WRITE` and `ADMINISTRATE` permissions, all other permissions will be ignored.
The ACL must contain at least one entry with all permissions set to `true`.
+ deprecated: true
tags:
- Things
parameters:
- $ref: '#/components/parameters/thingIdPathParam'
- $ref: '#/components/parameters/authorizationSubjectPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
responses:
'201':
@@ -660,12 +669,13 @@
identified by the `authorizationSubject` path parameter.
The ACL must contain at least one entry with all permissions set to `true`.
+ deprecated: true
tags:
- Things
parameters:
- $ref: '#/components/parameters/thingIdPathParam'
- $ref: '#/components/parameters/authorizationSubjectPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
responses:
'204':
@@ -705,12 +715,13 @@
summary: List all Attributes of a specific Thing
description: |-
Returns all Attributes of the Thing identified by the `thingId` path parameter.
+ deprecated: true
tags:
- Things
parameters:
- $ref: '#/components/parameters/thingIdPathParam'
- $ref: '#/components/parameters/attributesFieldsQueryParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
responses:
'200':
@@ -755,11 +766,12 @@
description: |-
Create or update the Attributes of a Thing identified by the `thingId` path parameter at once.
The Attributes will be replaced by the request body's JSON.
+ deprecated: true
tags:
- Things
parameters:
- $ref: '#/components/parameters/thingIdPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
responses:
'201':
@@ -827,11 +839,12 @@
summary: Delete all Attributes of a specific Thing at once
description: |-
Deletes all Attributes of the Thing identified by the `thingId` path parameter at once.
+ deprecated: true
tags:
- Things
parameters:
- $ref: '#/components/parameters/thingIdPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
responses:
'204':
@@ -872,12 +885,13 @@
description: |-
Returns a specific Attribute of the Thing identified by the `thingId` path parameter. The Attribute (JSON) can be referenced hierarchically by applying JSON Pointer notation (RFC-6901), e.g.:
`/things/{thingId}/attributes/address/city` in order to retrieve the `city` field of an `address` object.
+ deprecated: true
tags:
- Things
parameters:
- $ref: '#/components/parameters/thingIdPathParam'
- $ref: '#/components/parameters/attributePathPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
responses:
'200':
@@ -919,12 +933,13 @@
Create or update a specific Attribute of the Thing identified by the `thingId` path parameter.
The Attribute will be created if it doesn't exist or else updated. The Attribute (JSON) can be referenced hierarchically by applying JSON Pointer notation (RFC-6901), e.g.:
`/things/{thingId}/attributes/address/city` in order to create/update the `city` field of an `address` object.
+ deprecated: true
tags:
- Things
parameters:
- $ref: '#/components/parameters/thingIdPathParam'
- $ref: '#/components/parameters/attributePathPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
responses:
'201':
@@ -987,12 +1002,13 @@
description: |-
Deletes a specific Attribute of the Thing identified by the `thingId` path parameter. The Attribute (JSON) can be referenced hierarchically by applying JSON Pointer notation (RFC-6901), e.g.:
`/things/{thingId}/attributes/address/city` in order to delete the `city` field of an `address` object.
+ deprecated: true
tags:
- Things
parameters:
- $ref: '#/components/parameters/thingIdPathParam'
- $ref: '#/components/parameters/attributePathPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
responses:
'204':
@@ -1031,12 +1047,13 @@
summary: List all Features of a specific Thing
description: |-
Returns all Features of the Thing identified by the `thingId` path parameter.
+ deprecated: true
tags:
- Features
parameters:
- $ref: '#/components/parameters/thingIdPathParam'
- $ref: '#/components/parameters/featuresFieldsQueryParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
responses:
'200':
@@ -1092,11 +1109,12 @@
summary: Create or modify all Features of a specific Thing at once
description: |-
Create or modify the Features of a Thing identified by the `thingId` path parameter at once. The list of Features will be replaced by the request body's JSON.
+ deprecated: true
tags:
- Features
parameters:
- $ref: '#/components/parameters/thingIdPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
responses:
'201':
@@ -1173,11 +1191,12 @@
summary: Delete all Features of a specific Thing
description: |-
Deletes all features of the Thing identified by the `thingId` path parameter.
+ deprecated: true
tags:
- Features
parameters:
- $ref: '#/components/parameters/thingIdPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
responses:
'204':
@@ -1216,13 +1235,14 @@
summary: Retrieve a specific Feature of a specific Thing
description: |-
Returns a specific Feature identified by the `featureId` path parameter of the Thing identified by the `thingId` path parameter.
+ deprecated: true
tags:
- Features
parameters:
- $ref: '#/components/parameters/thingIdPathParam'
- $ref: '#/components/parameters/featureIdPathPathParam'
- $ref: '#/components/parameters/featureFieldsQueryParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
responses:
'200':
@@ -1267,12 +1287,13 @@
summary: Create or modify a specific Feature of a specific Thing
description: |-
Create or modify a specific Feature identified by the `featureId` path parameter of the Thing identified by the `thingId` path parameter.
+ deprecated: true
tags:
- Features
parameters:
- $ref: '#/components/parameters/thingIdPathParam'
- $ref: '#/components/parameters/featureIdPathPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
responses:
'201':
@@ -1347,12 +1368,13 @@
summary: Delete a specific Feature of a specific Thing
description: |-
Deletes a specific Feature identified by the `featureId` path parameter of the Thing identified by the `thingId` path parameter.
+ deprecated: true
tags:
- Features
parameters:
- $ref: '#/components/parameters/thingIdPathParam'
- $ref: '#/components/parameters/featureIdPathPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
responses:
'204':
@@ -1393,12 +1415,13 @@
description: |-
Returns the complete Definition of the Feature identified by the `thingId` and
`featureId` path parameter.
+ deprecated: true
tags:
- Features
parameters:
- $ref: '#/components/parameters/thingIdPathParam'
- $ref: '#/components/parameters/featureIdPathPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
responses:
'200':
@@ -1448,12 +1471,13 @@
Create or update the complete Definition of a Feature identified by the `thingId`
and `featureId` path parameter at once. The Definition will be replaced
by the request body's JSON array.
+ deprecated: true
tags:
- Features
parameters:
- $ref: '#/components/parameters/thingIdPathParam'
- $ref: '#/components/parameters/featureIdPathPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
responses:
'201':
@@ -1533,12 +1557,13 @@
description: |-
Deletes the complete Definition of the Feature identified by the `thingId` and
`featureId` path parameter.
+ deprecated: true
tags:
- Features
parameters:
- $ref: '#/components/parameters/thingIdPathParam'
- $ref: '#/components/parameters/featureIdPathPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
responses:
'204':
@@ -1581,13 +1606,14 @@
summary: List all Properties of a Feature.
description: |-
Returns all Properties of the Feature identified by the `thingId` and `featureId` path parameter.
+ deprecated: true
tags:
- Features
parameters:
- $ref: '#/components/parameters/thingIdPathParam'
- $ref: '#/components/parameters/featureIdPathPathParam'
- $ref: '#/components/parameters/propertiesFieldsQueryParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
responses:
'200':
@@ -1633,12 +1659,13 @@
description: |-
Create or update the Properties of a Feature identified by the `thingId` and `featureId` path parameter at once.
The Properties will be replaced by the request body's JSON.
+ deprecated: true
tags:
- Features
parameters:
- $ref: '#/components/parameters/thingIdPathParam'
- $ref: '#/components/parameters/featureIdPathPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
responses:
'201':
@@ -1709,12 +1736,13 @@
summary: Delete all Properties of a Feature.
description: |-
Deletes all Properties of the Feature identified by the `thingId` and `featureId` path parameter.
+ deprecated: true
tags:
- Features
parameters:
- $ref: '#/components/parameters/thingIdPathParam'
- $ref: '#/components/parameters/featureIdPathPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
responses:
'204':
@@ -1755,13 +1783,14 @@
description: |-
Returns the Property of the Feature identified by the `thingId` and `featureId` path parameter. The Property (JSON) can be referenced hierarchically by applying JSON Pointer notation (RFC-6901), e.g.:
`/things/{thingId}/features/{featureId}/properties/location/latitude` in order to retrieve the `latitude` field of an `location` Property.
+ deprecated: true
tags:
- Features
parameters:
- $ref: '#/components/parameters/thingIdPathParam'
- $ref: '#/components/parameters/featureIdPathPathParam'
- $ref: '#/components/parameters/propertyPathPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
responses:
'200':
@@ -1803,13 +1832,14 @@
Create or update a specific Property of a Feature identified by the `thingId` and `featureId` path parameter.
The Property will be created if it doesn't exist or else updated. The Property (JSON) can be referenced hierarchically by applying JSON Pointer notation (RFC-6901), e.g.:
`/things/{thingId}/features/{featureId}/properties/location/latitude` in order to create/update the `latitude` field of an `location` object.
+ deprecated: true
tags:
- Features
parameters:
- $ref: '#/components/parameters/thingIdPathParam'
- $ref: '#/components/parameters/featureIdPathPathParam'
- $ref: '#/components/parameters/propertyPathPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
responses:
'201':
@@ -1870,13 +1900,14 @@
description: |-
Deletes a specific Property of the Feature identified by the `thingId` and `featureId` path parameter. The Property (JSON) can be referenced hierarchically by applying JSON Pointer notation (RFC-6901), e.g.:
`/things/{thingId}/features/{featureId}/properties/location/latitude` in order to delete the `latitude` field of an `location` Property.
+ deprecated: true
tags:
- Features
parameters:
- $ref: '#/components/parameters/thingIdPathParam'
- $ref: '#/components/parameters/featureIdPathPathParam'
- $ref: '#/components/parameters/propertyPathPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
responses:
'204':
@@ -1921,6 +1952,7 @@
available or until the `timeout` is expired. If many clients respond to
the issued message, the first response will complete the HTTP request.
No special permissions are required to issue a Claim message.
+ deprecated: true
tags:
- Messages
parameters:
@@ -1973,6 +2005,7 @@
In order to handle the message in a fire and forget manner, add
a query-parameter `timeout=0` to the request.
+ deprecated: true
tags:
- Messages
parameters:
@@ -2024,6 +2057,7 @@
In order to handle the message in a fire and forget manner, add
a query-parameter `timeout=0` to the request.
+ deprecated: true
tags:
- Messages
parameters:
@@ -2075,6 +2109,7 @@
In order to handle the message in a fire and forget manner, add
a query-parameter `timeout=0` to the request.
+ deprecated: true
tags:
- Messages
parameters:
@@ -2127,6 +2162,7 @@
In order to handle the message in a fire and forget manner, add
a query-parameter `timeout=0` to the request.
+ deprecated: true
tags:
- Messages
parameters:
@@ -2179,6 +2215,7 @@
of the parent property `attributes` with a forward slash as separator:
```eq(attributes/location,"kitchen")```
+ deprecated: true
parameters:
- $ref: '#/components/parameters/searchFilter'
- $ref: '#/components/parameters/namespacesFilter'
@@ -2222,9 +2259,7 @@
The deprecated paging option `limit` may not combine with the other paging options `size` and `cursor`.
required: false
schema:
- type: array
- items:
- type: string
+ type: string
tags:
- Things-Search
@@ -2274,6 +2309,7 @@
of the parent property `attributes` with a forward slash as separator:
```eq(attributes/location,"kitchen")```
+ deprecated: true
parameters:
- $ref: '#/components/parameters/searchFilter'
- $ref: '#/components/parameters/namespacesFilter'
@@ -2562,12 +2598,22 @@
schema:
$ref: '#/components/schemas/AdvancedError'
parameters:
+ ifMatchHeaderParamHash:
+ name: If-Match
+ in: header
+ description: >-
+ The `If-Match` header which has to conform to RFC-7232 (Conditional Requests). Common usages are:
+ * optimistic locking by specifying the `ETag` from a previous HTTP response, e.g. `If-Match: "hash:a75ece4e"`
+ * retrieving or modifying a resource only if it already exists, e.g. `If-Match: *`
+ required: false
+ schema:
+ type: string
ifMatchHeaderParam:
name: If-Match
in: header
description: >-
The `If-Match` header which has to conform to RFC-7232 (Conditional Requests). Common usages are:
- * optimistic locking by specifying the `ETag` from a previous GET response, e.g. `If-Match: "rev:4711"`
+ * optimistic locking by specifying the `ETag` from a previous HTTP response, e.g. `If-Match: "rev:4711"`
* retrieving or modifying a resource only if it already exists, e.g. `If-Match: *`
required: false
schema:
diff --git a/1.0/openapi/ditto-api-2.yml b/1.0/openapi/ditto-api-2.yml
index f282d6c..5cdb377 100644
--- a/1.0/openapi/ditto-api-2.yml
+++ b/1.0/openapi/ditto-api-2.yml
@@ -20,15 +20,15 @@
description: "local Ditto"
tags:
- name: Things
- description: Manage every Thing
+ description: Manage every thing
- name: Features
- description: Structure the Features of your Things
+ description: Structure the features of your things
- name: Policies
- description: Control access to your Things
+ description: Control access to your things
- name: Things-Search
- description: Find every Thing
+ description: Find every thing
- name: Messages
- description: Talk with your Things
+ description: Talk with your things
security:
# - Google:
# - openid
@@ -40,28 +40,31 @@
###
/things:
get:
- summary: List all available Things
+ summary: Retrieve multiple things with specified IDs
description: |-
- Returns all Things passed in by the required parameter `ids`. Optionally
- you can use field selectors (see parameter `fields`) to only get the
- specified fields.
+ Returns all things passed in by the required parameter `ids`, which you (the authorized subject) are allowed to read.
+
+ Optionally, if you want to retrieve only some of the thing's fields, you can use the specific field selectors (see parameter `fields`) .
+
+ Tip: If you don't know the thing IDs, start with the search resource.
tags:
- - Things
+ - Things
parameters:
- - name: ids
- in: query
- description: |-
- Contains a comma separated list of `thingId`s to retrieve in one
- single request.
- required: true
- schema:
+ - name: ids
+ in: query
+ description: |-
+ Contains a comma-separated list of `thingId`s to retrieve in one
+ single request.
+ required: true
+ schema:
type: string
- - $ref: '#/components/parameters/thingFieldsQueryParam'
+ - $ref: '#/components/parameters/thingFieldsQueryParam'
+ - $ref: '#/components/parameters/timeoutParam'
responses:
'200':
description: |-
The successfully completed request contains as its result the first
- 200 for the user available Things, sorted by their `thingId`.
+ 200 things, for which the user has at least read permission. The list is sorted by the `thingId`.
content:
application/json:
schema:
@@ -88,21 +91,26 @@
The request could not be completed due to an URI length exceeding 8k
characters.
post:
- summary: Create a new Thing
+ summary: Create a new thing
description: |-
- Creates the Thing defined in the optional JSON body.
+ Creates a thing with a default `thingId` and a default `policyId`.
- The ID of the created Thing is a UUID generated by the service with the default namespace `org.eclipse.ditto`.
- Any `thingId` specified in the request body is
- therefore ignored. The Policy must include at least one entry with
- `WRITE` permission on the `policy:/` resource. If no Policy is provided,
- a default Policy will be created which grants all permissions to the
- authorized subject on the root thing and policy resource.
+ The thing will be empty, i.e. no features, definition, attributes etc. by default.
+
+ The default `thingId` consists of your default namespace and a UUID.
+
+ The default `policyId` is identical with the default `thingId`, and allows the currently authorized subject all permissions.
+
+ In case you need to create a thing with a specific ID, use a *PUT* request instead, as any `thingId` specified in the request body will be ignored.
tags:
- Things
+ parameters:
+ - $ref: '#/components/parameters/requestedAcksParam'
+ - $ref: '#/components/parameters/timeoutParam'
+ - $ref: '#/components/parameters/responseRequiredParam'
responses:
'201':
- description: The Thing was successfully created.
+ description: The thing was successfully created.
headers:
ETag:
description: |-
@@ -111,7 +119,7 @@
schema:
type: string
Location:
- description: The location of the created Thing resource
+ description: The location of the created thing resource
schema:
type: string
content:
@@ -122,9 +130,8 @@
description: |-
The request could not be completed. Possible reasons:
- * the `thingId` was wrongly set in the request body
- * the JSON of the Thing to be created was invalid
-
+ * the `thingId` must not be set in the request body
+ * the JSON body of the thing to be created is invalid
content:
application/json:
schema:
@@ -138,20 +145,21 @@
'403':
description: |-
- The request could not be completed. Either
- * as the caller would not have access to the thing after creating it with the given policy.
- * as the caller had insufficient permissions.
+ The request could not be completed.
+ Possible reasons:
+ * the caller would not have access to the thing after creating it with the given policy.
+ * the caller has insufficient permissions.
content:
application/json:
schema:
$ref: '#/components/schemas/AdvancedError'
'404':
description: |-
- The request could not be completed as either:
+ The request could not be completed. Possible reasons:
* the referenced thing does not exist.
* the caller had insufficient permissions to read the referenced thing.
- * the Policy that should be copied does not exist.
- * the caller had insufficient permissions to read the Policy that should be copied.
+ * the policy that should be copied does not exist.
+ * the caller had insufficient permissions to read the policy that should be copied.
content:
application/json:
schema:
@@ -165,17 +173,49 @@
application/json:
schema:
$ref: '#/components/schemas/NewThing'
- example: {}
- description: JSON representation of the Thing to be created.
+ example: {
+ "definition": "com.acme:coffeebrewer:0.1.0",
+ "attributes": {
+ "manufacturer": "ACME demo corp.",
+ "location": "Berlin, main floor",
+ "serialno": "42",
+ "model": "Speaking coffee machine"
+ },
+ "features": {
+ "coffee-brewer": {
+ "definition": [ "com.acme:coffeebrewer:0.1.0" ],
+ "properties": {
+ "brewed-coffees": 0
+ }
+ },
+ "water-tank": {
+ "properties": {
+ "configuration": {
+ "smartMode": true,
+ "brewingTemp": 87,
+ "tempToHold": 44,
+ "timeoutSeconds": 6000
+ },
+ "status": {
+ "waterAmount": 731,
+ "temperature": 44
+ }
+ }
+ }
+ }
+ }
+ description: JSON representation of the thing to be created. Use { } to create an empty thing with a default policy.
'/things/{thingId}':
get:
- summary: Retrieve a specific Thing
+ summary: Retrieve a specific thing
description: |-
- Returns the Thing identified by the `thingId` path parameter. The
- response includes details about the Thing. Note that the Thing's Policy
- is not included in the response per default. Optionally you can use
- field selectors (see parameter `fields`) to only get the specified
- fields. E.g., you can get the Thing's Policy by using a field selector.
+ Returns the thing identified by the `thingId` path parameter. The
+ response includes details about the thing, including the `policyId`, attributes, definition and features.
+
+ Optionally, you can use the field selectors (see parameter `fields`) to only get specific
+ fields, which you are interested in.
+
+ Example: Use the field selector `_policy` to retrieve the content of the policy.
tags:
- Things
parameters:
@@ -183,9 +223,10 @@
- $ref: '#/components/parameters/thingFieldsQueryParam'
- $ref: '#/components/parameters/ifMatchHeaderParam'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/timeoutParam'
responses:
'200':
- description: The request successfully returned the specific Thing.
+ description: The request successfully returned the specific thing.
headers:
ETag:
description: |-
@@ -201,9 +242,10 @@
$ref: '#/components/responses/notModified'
'400':
description: |-
- The request could not be completed. Either the `thingId` does not conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id))
- or one of the defined query parameters was invalid.
+ The request could not be completed. Possible reasons:
+
+ * the `thingId` does not conform to the namespaced entity ID notation (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id))
+ * at least one of the defined query parameters is invalid
content:
application/json:
schema:
@@ -217,7 +259,7 @@
'404':
description: |-
- The request could not be completed. The Thing with the given ID was
+ The request could not be completed. The thing with the given ID was
not found.
content:
application/json:
@@ -226,98 +268,122 @@
'412':
$ref: '#/components/responses/preconditionFailed'
put:
- summary: Create or update a Thing with a specified ID
+ summary: Create or update a thing with a specified ID
description: |-
- Create or update the Thing specified by the `thingId` path parameter and
- the optional JSON body. The `thingId` does not conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
+ Create or update the thing specified by the `thingId` path parameter and
+ the optional JSON body.
- #### Valid examples
-
- * `com.bosch.myproject:myFridge1`
- * `mynamespace:myFridge1`
-
- #### Invalid examples
-
- * `42:myFridge1`
- * `.foo:myFridge1`
- * `bar.:myFridge1`
-
- The ID of a Thing can't be changed after creation. Any `thingId`
- specified in the request body is therefore ignored.
-
- ### Creation of a new Thing
-
- The Policy must include at least one entry with `WRITE` permission on
- the `policy:/` resource. If no Policy is provided, a default Policy will
- be created which grants all permissions to the authorized subject on the
- root thing and policy resource.
-
- ### Permissions for updating an existing Thing
-
- For updating an existing Thing the authorized subject has to have an
- unrestricted `WRITE` permission on the Thing's root resource.
-
- ### Partially updating an existing Thing
-
- When updating an existing Thing already containing `attributes`, `definition`, `policyId` or `features` the already existing fields
- must not explicitly be provided again. For this "PUT Thing" request (and only for this top-level update on the
- Thing) the top-level field to update is merged with the existing top-level fields of the Thing.
+ * If you set a new `thingId` in the path, a thing will be created.
+ * If you set an existing `thingId` in the path, the thing will be updated.
- For example: A Thing already exists with this content:
+ ### Create a new thing
+ At the initial creation of a thing, only a valid `thingId` is required.
+ However, you can create a full-fledged thing all at once.
+
+ Example:
+ To create a coffee maker thing, set the `thingId` in the path, e.g. to "com.acme.coffeemaker:BE-42"
+ and the body part, like in the following snippet.
```
+ {
+ "definition": "com.acme:coffeebrewer:0.1.0",
+ "attributes": {
+ "manufacturer": "ACME demo corp.",
+ "location": "Berlin, main floor",
+ "serialno": "42",
+ "model": "Speaking coffee machine"
+ },
+ "features": {
+ "coffee-brewer": {
+ "definition": [ "com.acme:coffeebrewer:0.1.0" ],
+ "properties": {
+ "brewed-coffees": 0
+ }
+ },
+ "water-tank": {
+ "properties": {
+ "configuration": {
+ "smartMode": true,
+ "brewingTemp": 87,
+ "tempToHold": 44,
+ "timeoutSeconds": 6000
+ },
+ "status": {
+ "waterAmount": 731,
+ "temperature": 44
+ }
+ }
+ }
+ }
+ }
+ ```
+ As the example does not set a policy in the request body, but the thing concept requires one,
+ the service will create a default policy. The default policy, has the exactly same id
+ as the thing, and grants ALL permissions to the authorized subject.
+ In case you need to associate the new thing to an already existing policy you can additionally
+ set a policy e.g. "policyId": "com.acme.coffeemaker:policy-1" as the first element in the body part.
+ Keep in mind, that you can also change the assignment to another policy anytime,
+ with a request on the sub-resource "PUT /things/{thingId}/policyId"
+
+ ### Update an existing thing
+
+ For updating an existing thing, the authorized subject needs **WRITE** permission on the thing's root resource.
+
+ The ID of a thing cannot be changed after creation. Any `thingId`
+ specified in the request body is therefore ignored.
+
+ ### Partially update an existing thing
+
+ When updating an existing thing, which already contains `attributes`, `definition` `policyId` or `features`,
+ the existing fields must not explicitly be provided again.
+ For this "PUT thing" request - and only for this top-level update on the thing -
+ the top-level field to update is **merged** with the existing top-level fields of the thing.
+
+ ### Example for a partial update
+
+ Given, a thing already exists with this content:
+
+ ```
{
"thingId": "namespace:thing-name",
"policyId": "namespace:policy-name",
- "definition": "namespace:name:version",
+ "definition": "namespace:model:version",
"attributes": {
"foo": 1
},
"features": {...}
}
-
```
- The Thing's `attributes` and `definition` may be modified without having to pass the `policyId` or the `features` in again. The content
- of the request's body would be sufficient for updating the `attributes` and `definition`:
+ The thing's `attributes` may be modified without having to pass the `policyId` or
+ the `features` in again.
+ For updating the `attributes`, following request body would be sufficient :
```
-
{
"attributes": {
"foo": 2,
"bar": false
}
}
-
```
- ```
-
- {
- "definition": "example:test:01"
- }
-
- ```
-
- The `policyId` and `features` of the Thing will not be overwritten, the Thing will be merged as one would expect it:
+ The `policyId` and `features` of the thing will not be overwritten.
+ The thing will be merged into:
```
-
{
"thingId": "namespace:thing-name",
"policyId": "namespace:policy-name",
- "definition": "example:test:01",
+ "definition": "namespace:model:version",
"attributes": {
"foo": 2,
"bar": false
},
"features": {...}
}
-
```
tags:
- Things
@@ -325,9 +391,12 @@
- $ref: '#/components/parameters/thingIdPathParam'
- $ref: '#/components/parameters/ifMatchHeaderParam'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/requestedAcksParam'
+ - $ref: '#/components/parameters/timeoutParam'
+ - $ref: '#/components/parameters/responseRequiredParam'
responses:
'201':
- description: The Thing was successfully created.
+ description: The thing was successfully created.
headers:
ETag:
description: |-
@@ -336,7 +405,7 @@
schema:
type: string
Location:
- description: The location of the created Thing resource
+ description: The location of the created thing resource
schema:
type: string
content:
@@ -344,7 +413,7 @@
schema:
$ref: '#/components/schemas/Thing'
'204':
- description: The Thing was successfully modified.
+ description: The thing was successfully modified.
headers:
ETag:
description: |-
@@ -354,10 +423,12 @@
type: string
'400':
description: |-
- The request could not be completed. Either the `thingId` does not conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id))
- or the JSON of the Thing to be created/modified was either invalid
- or did contain a `thingId` which did not match the ID in the URL.
+ The request could not be completed. Possible reasons:
+
+ * the `thingId` does not conform to the namespaced entity ID notation (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id))
+ * the JSON body of the thing to be created/modified is invalid
+ * the JSON body of the thing to be created/modified contains a `thingId`
+ which does not match the ID in the path
content:
application/json:
schema:
@@ -371,21 +442,21 @@
'403':
description: |-
- The request could not be completed. Either
- * as the caller would not have access to the thing after creating it with the given policy.
- * as the caller had insufficient permissions.
- For modifying an existing Thing an unrestricted `WRITE` permission on the Thing's root resource is required.
+ The request could not be completed. Possible reasons:
+ * the caller would not have access to the thing after creating it with the given policy
+ * the caller has insufficient permissions.
+ For modifying an existing thing, an unrestricted `WRITE` permission on the thing's root resource is required.
content:
application/json:
schema:
$ref: '#/components/schemas/AdvancedError'
'404':
description: |-
- The request could not be completed as either:
+ The request could not be completed. Possible reasons:
* the referenced thing does not exist.
- * the caller had insufficient permissions to read the referenced thing.
- * the Policy that should be copied does not exist.
- * the caller had insufficient permissions to read the Policy that should be copied.
+ * the caller has insufficient permissions to read the referenced thing.
+ * the policy that should be copied does not exist.
+ * the caller has insufficient permissions to read the policy that should be copied.
content:
application/json:
schema:
@@ -399,27 +470,62 @@
application/json:
schema:
$ref: '#/components/schemas/NewThing'
- example: {}
- description: JSON representation of the Thing to be modified.
+ example: {
+ "definition": "com.acme:coffeebrewer:0.1.0",
+ "attributes": {
+ "manufacturer": "ACME demo corp.",
+ "location": "Berlin, main floor",
+ "serialno": "42",
+ "model": "Speaking coffee machine"
+ },
+ "features": {
+ "coffee-brewer": {
+ "definition": ["com.acme:coffeebrewer:0.1.0"],
+ "properties": {
+ "brewed-coffees": 0
+ }
+ },
+ "water-tank": {
+ "properties": {
+ "configuration": {
+ "smartMode": true,
+ "brewingTemp": 87,
+ "tempToHold": 44,
+ "timeoutSeconds": 6000
+ },
+ "status": {
+ "waterAmount": 731,
+ "temperature": 44
+ }
+ }
+ }
+ }
+ }
+ description: JSON representation of the thing to be modified.
delete:
- summary: Delete a specific Thing
+ summary: Delete a specific thing
description: |-
- Deletes the Thing identified by the `thingId` path parameter. This will
- not delete the Policy used for controlling access to this Thing managed
- by resource `/policies/{policyId}`.
+ Deletes the thing identified by the `thingId` path parameter.
+
+ This will not delete the policy, which is used for controlling access to this thing.
+
+ You can delete the policy afterwards via DELETE `/policies/{policyId}` if you don't need it for other things.
tags:
- Things
parameters:
- $ref: '#/components/parameters/thingIdPathParam'
- $ref: '#/components/parameters/ifMatchHeaderParam'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/requestedAcksParam'
+ - $ref: '#/components/parameters/timeoutParam'
+ - $ref: '#/components/parameters/responseRequiredParam'
responses:
'204':
- description: The Thing was successfully deleted.
+ description: The thing was successfully deleted.
'400':
description: |-
- The request could not be completed. The `thingId` does not conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
+ The request could not be completed. Possible reasons:
+ * the `thingId` does not conform to the namespaced entity ID notation (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
content:
application/json:
schema:
@@ -432,14 +538,16 @@
$ref: '#/components/schemas/AdvancedError'
'403':
description: |-
- The request could not be completed as the caller had insufficient permissions. For deleting an existing Thing an unrestricted `WRITE` permission on the Thing's root resource is required.
+ The request could not be completed. Possible reasons:
+ * the caller had insufficient permissions.
+ For deleting an existing thing, an unrestricted `WRITE` permission on the thing's root resource is required.
content:
application/json:
schema:
$ref: '#/components/schemas/AdvancedError'
'404':
description: |-
- The request could not be completed. The Thing with the given ID was
+ The request could not be completed. The thing with the given ID was
not found.
content:
application/json:
@@ -447,21 +555,24 @@
$ref: '#/components/schemas/AdvancedError'
'412':
$ref: '#/components/responses/preconditionFailed'
-
+ ###
+ ### Definition
+ ###
'/things/{thingId}/definition':
get:
- summary: Retrieve the definition of a specific Thing
+ summary: Retrieve the definition of a specific thing
description: |-
- Returns the definition of the Thing identified by the `thingId` path parameter.
+ Returns the definition of the thing identified by the `thingId` path parameter.
tags:
- Things
parameters:
- $ref: '#/components/parameters/thingIdPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/timeoutParam'
responses:
'200':
- description: The request successfully returned the definition of the specific Thing.
+ description: The request successfully returned the definition of the specific thing.
headers:
ETag:
description: |-
@@ -477,9 +588,10 @@
$ref: '#/components/responses/notModified'
'400':
description: |-
- The request could not be completed. Either the `thingId` does not conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id))
- or one of the defined query parameters was invalid.
+ The request could not be completed. Possible reasons:
+
+ * the `thingId` does not conform to the namespaced entity ID notation
+ (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
content:
application/json:
schema:
@@ -490,10 +602,19 @@
application/json:
schema:
$ref: '#/components/schemas/AdvancedError'
+ '403':
+ description: |-
+ The request could not be completed. Possible reasons:
+ * the caller has insufficient permissions.
+ For modifying the definition of an existing thing, `WRITE` permission is required.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
'404':
description: |-
- The request could not be completed. The Thing with the given ID was
+ The request could not be completed. The thing with the given ID was
not found.
content:
application/json:
@@ -502,16 +623,20 @@
'412':
$ref: '#/components/responses/preconditionFailed'
put:
- summary: Create or update the definition of a specific Thing
+ summary: Create or update the definition of a specific thing
description: |-
- Create or update the definition of a Thing identified by the `thingId` path parameter.
- The definition will be replaced by the request body's JSON string value.
+ * If the thing does not have a definition yet, this request will create it.
+ * If the thing already has a definition you can assign it to a new one by setting the new definition in the request body.
+
tags:
- Things
parameters:
- $ref: '#/components/parameters/thingIdPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/requestedAcksParam'
+ - $ref: '#/components/parameters/timeoutParam'
+ - $ref: '#/components/parameters/responseRequiredParam'
responses:
'201':
description: The definition was successfully created.
@@ -541,9 +666,12 @@
type: string
'400':
description: |-
- The request could not be completed. Either the `thingId` does not conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id))
- or the JSON was invalid or was not a JSON object.
+ The request could not be completed. Possible reasons:
+
+ * the `thingId` does not conform to the namespaced entity ID notation
+ (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id))
+ * the JSON was invalid
+ * the request body was not a JSON object.
content:
application/json:
schema:
@@ -557,14 +685,17 @@
'403':
description: |-
- The request could not be completed as the caller had insufficient permissions. For modifying the definition of an existing Thing `WRITE` permission is required.
+ The request could not be completed. Possible reasons:
+
+ * the caller has insufficient permissions.
+ For modifying a definition of an existing thing, `WRITE` permission is required.
content:
application/json:
schema:
$ref: '#/components/schemas/AdvancedError'
'404':
description: |-
- The request could not be completed. The Thing with the given ID was
+ The request could not be completed. The thing with the given ID was
not found.
content:
application/json:
@@ -577,15 +708,18 @@
requestBody:
$ref: '#/components/requestBodies/Definition'
delete:
- summary: Delete the definition of a specific Thing
+ summary: Delete the definition of a specific thing
description: |-
- Deletes the definition of the Thing identified by the `thingId` path parameter.
+ Deletes the definition of the thing identified by the `thingId`.
tags:
- Things
parameters:
- $ref: '#/components/parameters/thingIdPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/requestedAcksParam'
+ - $ref: '#/components/parameters/timeoutParam'
+ - $ref: '#/components/parameters/responseRequiredParam'
responses:
'204':
description: The definition was successfully deleted.
@@ -605,14 +739,17 @@
$ref: '#/components/schemas/AdvancedError'
'403':
description: |-
- The request could not be completed as the caller had insufficient permissions. For deleting the definition of an existing Thing `WRITE` permission is required.
+ The request could not be completed. Possible reasons:
+
+ * the caller has insufficient permissions.
+ For modifying a definition of an existing thing, `WRITE` permission is required.
content:
application/json:
schema:
$ref: '#/components/schemas/AdvancedError'
'404':
description: |-
- The request could not be completed. The Thing with the given ID or
+ The request could not be completed. The thing with the given ID or
its definition was not found.
content:
application/json:
@@ -622,18 +759,19 @@
$ref: '#/components/responses/preconditionFailed'
'/things/{thingId}/policyId':
get:
- summary: Retrieve the Policy ID of a Thing
+ summary: Retrieve the policy ID of a thing
description: |-
- Returns the Policy ID of the Thing identified by the `thingId` path parameter.
+ Returns the policy ID of the thing identified by the `thingId` path parameter.
tags:
- Things
parameters:
- $ref: '#/components/parameters/thingIdPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/timeoutParam'
responses:
'200':
- description: The request successfully returned the Policy ID.
+ description: The request successfully returned the policy ID.
headers:
ETag:
description: |-
@@ -649,8 +787,8 @@
$ref: '#/components/responses/notModified'
'400':
description: |-
- The request could not be completed. The `thingId` does not conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
+ The request could not be completed. Possible reasons:
+ * the `thingId` does not conform to the namespaced entity ID notation (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
content:
application/json:
schema:
@@ -662,7 +800,7 @@
schema:
$ref: '#/components/schemas/AdvancedError'
'404':
- description: The request could not be completed. The Thing with the given ID was not found in the context of the authenticated user.
+ description: The request could not be completed. The thing with the given ID was not found in the context of the authenticated user.
content:
application/json:
schema:
@@ -670,22 +808,34 @@
'412':
$ref: '#/components/responses/preconditionFailed'
put:
- summary: Create or update the Policy ID of a Thing
+ summary: Create or update the policy ID of a thing
description: |-
- Create or update the Policy ID of the Thing identified by the `thingId`
- path parameter. If the Thing had not yet a `policyId` set it was
- considered to be in API version 1, access controlled by the `acl`
- mechanism. In that case PUTing a `policyId` will create the Policy ID.
+ Create or update the policy ID of the thing identified by the `thingId`
+ path parameter.
+
+ ### Create
+ If the thing does not have a `policyId` yet, it is
+ considered to have been created via API version 1, where the access control list `acl`
+ mechanism is used. In that case, this request will create the `policyId`.
+
+ Note: You will need to create the policy content separately.
+
+ ### Update
+ If the thing already has a `policyId` you can assign it to an existing policy by setting
+ the new `policyId` in the request body.
tags:
- Things
parameters:
- $ref: '#/components/parameters/thingIdPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/requestedAcksParam'
+ - $ref: '#/components/parameters/timeoutParam'
+ - $ref: '#/components/parameters/responseRequiredParam'
responses:
'201':
description: |-
- The Policy ID was successfully created - the Thing was migrated to API version 2.
+ The policy ID was successfully created. Note: You will need to create the policy content separately.
headers:
ETag:
description: |-
@@ -698,7 +848,7 @@
schema:
type: string
'204':
- description: The Policy ID was successfully updated.
+ description: The policy ID was successfully updated.
headers:
ETag:
description: |-
@@ -708,8 +858,9 @@
type: string
'400':
description: |-
- The request could not be completed. The `thingId` does not conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
+ The request could not be completed. Possible reasons:
+
+ * the `thingId` does not conform to the namespaced entity ID notation (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id))
content:
application/json:
schema:
@@ -724,7 +875,7 @@
'404':
description: |-
- The request could not be completed. The Thing with the given ID was
+ The request could not be completed. The thing with the given ID was
not found in the context of the authenticated user.
content:
application/json:
@@ -739,27 +890,29 @@
application/json:
schema:
type: string
- example: '<namespace>:<policyName>'
+ example: "\"your.namespace:your-policy-name\""
description: |-
- The Policy ID used for controlling access to this Thing. Managed by
- resource `/policies/{policyId}`. The `policyId` has to conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
+ The policy is used for controlling access to this thing. It is managed by
+ resource `/policies/{policyId}`.
+
+ The ID of a policy needs to conform to the namespaced entity ID notation (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
required: true
'/things/{thingId}/attributes':
get:
- summary: List all Attributes of a specific Thing
+ summary: List all attributes of a specific thing
description: |-
- Returns all Attributes of the Thing identified by the `thingId` path parameter.
+ Returns all attributes of the thing identified by the `thingId` path parameter.
tags:
- Things
parameters:
- $ref: '#/components/parameters/thingIdPathParam'
- $ref: '#/components/parameters/attributesFieldsQueryParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/timeoutParam'
responses:
'200':
- description: The Attributes of the specific Thing were successfully retrieved.
+ description: The attributes of the specific thing were successfully retrieved.
headers:
ETag:
description: |-
@@ -775,8 +928,9 @@
$ref: '#/components/responses/notModified'
'400':
description: |-
- The request could not be completed. The `thingId` does not conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
+ The request could not be completed. Possible reasons:
+
+ * the `thingId` does not conform to the namespaced entity ID notation (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id))
content:
application/json:
schema:
@@ -790,7 +944,7 @@
'404':
description: |-
- The request could not be completed. The Thing with the given ID was not found.
+ The request could not be completed. The thing with the given ID was not found.
content:
application/json:
schema:
@@ -798,20 +952,23 @@
'412':
$ref: '#/components/responses/preconditionFailed'
put:
- summary: Create or update all Attributes of a specific Thing at once
+ summary: Create or update all attributes of a specific thing at once
description: |-
- Create or update the Attributes of a Thing identified by the `thingId`
- path parameter at once. The Attributes will be replaced by the request
- body's JSON.
+ Create or update the attributes of a thing identified by the `thingId`
+ path parameter. The attributes will be overwritten - all at once - with the
+ content (JSON) set in the request body.
tags:
- Things
parameters:
- $ref: '#/components/parameters/thingIdPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/requestedAcksParam'
+ - $ref: '#/components/parameters/timeoutParam'
+ - $ref: '#/components/parameters/responseRequiredParam'
responses:
'201':
- description: The Attributes were successfully created.
+ description: The attributes were successfully created.
headers:
ETag:
description: |-
@@ -820,7 +977,7 @@
schema:
type: string
Location:
- description: The location of the created Attribute resource
+ description: The location of the created attribute resource
schema:
type: string
content:
@@ -828,7 +985,7 @@
schema:
$ref: '#/components/schemas/Attributes'
'204':
- description: The Attributes were successfully updated.
+ description: The attributes were successfully updated.
headers:
ETag:
description: |-
@@ -838,9 +995,9 @@
type: string
'400':
description: |-
- The request could not be completed. Either the `thingId` does not conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id))
- or the JSON was invalid or was not a JSON object.
+ The request could not be completed. Possible reasons:
+ * the `thingId` does not conform to the namespaced entity ID notation (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
+ * the JSON body of the attributes to be created/modified is invalid
content:
application/json:
schema:
@@ -854,14 +1011,16 @@
'403':
description: |-
- The request could not be completed as the caller had insufficient permissions. For modifying the Attributes of an existing Thing `WRITE` permission is required.
+ The request could not be completed. Possible reasons:
+ * the caller has insufficient permissions.
+ For modifying the attributes of an existing thing, `WRITE` permission is required.
content:
application/json:
schema:
$ref: '#/components/schemas/AdvancedError'
'404':
description: |-
- The request could not be completed. The Thing with the given ID was
+ The request could not be completed. The thing with the given ID was
not found.
content:
application/json:
@@ -874,23 +1033,26 @@
requestBody:
$ref: '#/components/requestBodies/Attributes'
delete:
- summary: Delete all Attributes of a specific Thing at once
+ summary: Delete all attributes of a specific thing at once
description: |-
- Deletes all Attributes of the Thing identified by the `thingId` path
- parameter at once.
+ Deletes all attributes of the thing identified by the `thingId` path
+ parameter.
tags:
- Things
parameters:
- $ref: '#/components/parameters/thingIdPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/requestedAcksParam'
+ - $ref: '#/components/parameters/timeoutParam'
+ - $ref: '#/components/parameters/responseRequiredParam'
responses:
'204':
- description: The Attributes were successfully deleted.
+ description: The attributes were successfully deleted.
'400':
description: |-
- The request could not be completed. The `thingId` does not conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
+ The request could not be completed. Possible reasons:
+ * the `thingId` does not conform to the namespaced entity ID notation (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
content:
application/json:
schema:
@@ -903,15 +1065,17 @@
$ref: '#/components/schemas/AdvancedError'
'403':
description: |-
- The request could not be completed as the caller had insufficient permissions. For deleting all Attributes of an existing Thing `WRITE` permission is required.
+ The request could not be completed. Possible reasons:
+ * the caller has insufficient permissions.
+ For deleting all attributes of an existing thing, `WRITE` permission is required.
content:
application/json:
schema:
$ref: '#/components/schemas/AdvancedError'
'404':
description: |-
- The request could not be completed. The Thing with the given ID or
- its Attributes were not found.
+ The request could not be completed. The thing with the given ID or
+ its attributes were not found.
content:
application/json:
schema:
@@ -920,23 +1084,29 @@
$ref: '#/components/responses/preconditionFailed'
'/things/{thingId}/attributes/{attributePath}':
get:
- summary: Retrieve a specific Attribute of a specific Thing
+ summary: Retrieve a specific attribute of a specific thing
description: |-
- Returns a specific Attribute of the Thing identified by the `thingId`
- path parameter. The Attribute (JSON) can be referenced hierarchically by
- applying JSON Pointer notation (RFC-6901), e.g.:
- `/things/{thingId}/attributes/address/city` in order to retrieve the
- `city` field of an `address` object.
+ Returns a specific attribute of the thing identified by the `thingId`
+ path parameter.
+
+ The attribute (JSON) can be referenced hierarchically, by
+ applying JSON Pointer notation (RFC-6901).
+
+ Example:
+ In order to retrieve the `name` field of an `manufacturer` attribute,
+ the full path would be
+ `/things/{thingId}/attributes/manufacturer/name`
tags:
- Things
parameters:
- $ref: '#/components/parameters/thingIdPathParam'
- $ref: '#/components/parameters/attributePathPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/timeoutParam'
responses:
'200':
- description: The Attribute was successfully retrieved.
+ description: The attribute was successfully retrieved.
headers:
ETag:
description: |-
@@ -948,8 +1118,8 @@
$ref: '#/components/responses/notModified'
'400':
description: |-
- The request could not be completed. The `thingId` does not conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
+ The request could not be completed. Possible reasons:
+ * the `thingId` does not conform to the namespaced entity ID notation (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
content:
application/json:
schema:
@@ -963,8 +1133,8 @@
'404':
description: |-
- The request could not be completed. The Thing with the given ID or
- the Attribute at the specified path was not found.
+ The request could not be completed. The thing with the given ID or
+ the attribute at the specified path was not found.
content:
application/json:
schema:
@@ -972,24 +1142,31 @@
'412':
$ref: '#/components/responses/preconditionFailed'
put:
- summary: Create or update a specific Attribute of a specific Thing
+ summary: Create or update a specific attribute of a specific thing
description: |-
- Create or update a specific Attribute of the Thing identified by the
- `thingId` path parameter. The Attribute will be created if it doesn't
- exist or else updated. The Attribute (JSON) can be referenced
- hierarchically by applying JSON Pointer notation (RFC-6901), e.g.:
- `/things/{thingId}/attributes/address/city` in order to create/update
- the `city` field of an `address` object.
+ Create or update a specific attribute of the thing identified by the
+ `thingId` path parameter.
+
+ * If you specify a new attribute path, this will be created
+ * If you specify an existing attribute path, this will be updated
+
+ The attribute (JSON) can be referenced hierarchically, by applying JSON Pointer notation (RFC-6901).
+
+ Example: In order to put the `name` field of an `manufacturer` attribute, the full path would be
+ `/things/{thingId}/attributes/manufacturer/name`
tags:
- Things
parameters:
- $ref: '#/components/parameters/thingIdPathParam'
- $ref: '#/components/parameters/attributePathPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/requestedAcksParam'
+ - $ref: '#/components/parameters/timeoutParam'
+ - $ref: '#/components/parameters/responseRequiredParam'
responses:
'201':
- description: The Attribute was successfully created.
+ description: The attribute was successfully created.
headers:
ETag:
description: |-
@@ -998,11 +1175,11 @@
schema:
type: string
Location:
- description: The location of the created Attribute resource
+ description: The location of the created attribute resource
schema:
type: string
'204':
- description: The Attribute was successfully modified.
+ description: The attribute was successfully modified.
headers:
ETag:
description: |-
@@ -1012,8 +1189,8 @@
type: string
'400':
description: |-
- The request could not be completed. The `thingId` does not conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
+ The request could not be completed. Possible reasons:
+ * the `thingId` does not conform to the namespaced entity ID notation (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
content:
application/json:
schema:
@@ -1027,14 +1204,16 @@
'403':
description: |-
- The request could not be completed as the caller had insufficient permissions. For modifying a single Attribute of an existing Thing `WRITE` permission is required.
+ The request could not be completed. Possible reasons:
+ * the caller has insufficient permissions.
+ For modifying an attribute of an existing thing, `WRITE` permission is required.
content:
application/json:
schema:
$ref: '#/components/schemas/AdvancedError'
'404':
description: |-
- The request could not be completed. The Thing with the given ID was
+ The request could not be completed. The thing with the given ID was
not found.
content:
application/json:
@@ -1047,27 +1226,32 @@
requestBody:
$ref: '#/components/requestBodies/Value'
delete:
- summary: Delete a specific Attribute of a specific Thing
+ summary: Delete a specific attribute of a specific thing
description: |-
- Deletes a specific Attribute of the Thing identified by the `thingId`
- path parameter. The Attribute (JSON) can be referenced hierarchically by
- applying JSON Pointer notation (RFC-6901), e.g.:
- `/things/{thingId}/attributes/address/city` in order to delete the
- `city` field of an `address` object.
+ Deletes a specific attribute of the thing identified by the `thingId`
+ path parameter.
+
+ The attribute (JSON) can be referenced hierarchically, by applying JSON Pointer notation (RFC-6901).
+
+ Example: In order to delete the `name` field of an `manufacturer` attribute, the full path would be
+ `/things/{thingId}/attributes/manufacturer/name`
tags:
- Things
parameters:
- $ref: '#/components/parameters/thingIdPathParam'
- $ref: '#/components/parameters/attributePathPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/requestedAcksParam'
+ - $ref: '#/components/parameters/timeoutParam'
+ - $ref: '#/components/parameters/responseRequiredParam'
responses:
'204':
- description: The Attribute was successfully deleted.
+ description: The attribute was successfully deleted.
'400':
description: |-
- The request could not be completed. The `thingId` does not conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
+ The request could not be completed. Possible reasons:
+ * the `thingId` does not conform to the namespaced entity ID notation (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
content:
application/json:
schema:
@@ -1080,15 +1264,17 @@
$ref: '#/components/schemas/AdvancedError'
'403':
description: |-
- The request could not be completed as the caller had insufficient permissions. For deleting a single Attribute of an existing Thing `WRITE` permission is required.
+ The request could not be completed. Possible reasons:
+ * the caller has insufficient permissions.
+ For deleting a single attribute of an existing thing, `WRITE` permission is required.
content:
application/json:
schema:
$ref: '#/components/schemas/AdvancedError'
'404':
description: |-
- The request could not be completed. The Thing with the given ID or
- the Attribute at the specified path was not found.
+ The request could not be completed. The thing with the given ID or
+ the attribute at the specified path was not found.
content:
application/json:
schema:
@@ -1100,21 +1286,22 @@
###
'/things/{thingId}/features':
get:
- summary: List all Features of a specific Thing
+ summary: List all features of a specific thing
description: |-
- Returns all Features of the Thing identified by the `thingId` path
+ Returns all features of the thing identified by the `thingId` path
parameter.
tags:
- Features
parameters:
- $ref: '#/components/parameters/thingIdPathParam'
- $ref: '#/components/parameters/featuresFieldsQueryParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/timeoutParam'
responses:
'200':
description: |-
- The list of Features of the specific Thing were successfully
+ The list of features of the specific thing were successfully
retrieved.
headers:
ETag:
@@ -1142,9 +1329,9 @@
$ref: '#/components/responses/notModified'
'400':
description: |-
- The request could not be completed. Either the `thingId` does not conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id))
- or at least one of the defined query parameters was invalid.
+ The request could not be completed. Possible reasons:
+ * the `thingId` does not conform to the namespaced entity ID notation (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
+ * at least one of the defined query parameters is invalid.
content:
application/json:
schema:
@@ -1158,8 +1345,8 @@
'404':
description: |-
- The request could not be completed. The Thing with the given ID was
- not found or the Features have not been defined.
+ The request could not be completed. The thing with the given ID was
+ not found or the features have not been defined.
content:
application/json:
schema:
@@ -1167,20 +1354,58 @@
'412':
$ref: '#/components/responses/preconditionFailed'
put:
- summary: Create or modify all Features of a specific Thing at once
+ summary: Create or modify all features of a specific thing at once
description: |-
- Create or modify the Features of a Thing identified by the `thingId`
- path parameter at once. The list of Features will be replaced by the
- request body's JSON.
+ Create or modify all features of a thing identified by the `thingId`
+ path parameter.
+ ### Create all features at once
+ In case at the initial creation of your thing you have not specified any features, these can be created here.
+
+ ### Update all features at once
+ To update all features at once prepare the JSON body accordingly.
+
+ Note: In contrast to the "PUT thing" request, a partial update is not supported here,
+ but the content will be **overwritten**.
+ If you need to update single features or their paths, please use the sub-resources instead.
+
+ Example:
+
+ ```
+ {
+ "coffee-brewer": {
+ "definition": ["com.acme:coffeebrewer:0.1.0"],
+ "properties": {
+ "brewed-coffees": 0
+ }
+ },
+ "water-tank": {
+ "properties": {
+ "configuration": {
+ "smartMode": true,
+ "brewingTemp": 87,
+ "tempToHold": 44,
+ "timeoutSeconds": 6000
+ },
+ "status": {
+ "waterAmount": 731,
+ "temperature": 44
+ }
+ }
+ }
+ }
+ ```
tags:
- Features
parameters:
- $ref: '#/components/parameters/thingIdPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/requestedAcksParam'
+ - $ref: '#/components/parameters/timeoutParam'
+ - $ref: '#/components/parameters/responseRequiredParam'
responses:
'201':
- description: The Features were successfully created.
+ description: The features were successfully created.
headers:
ETag:
description: |-
@@ -1189,7 +1414,7 @@
schema:
type: string
Location:
- description: The location of the created Features resource
+ description: The location of the created features resource
schema:
type: string
content:
@@ -1199,7 +1424,7 @@
example:
{}
'204':
- description: The Features were successfully modified.
+ description: The features were successfully modified.
headers:
ETag:
description: |-
@@ -1209,9 +1434,9 @@
type: string
'400':
description: |-
- The request could not be completed. Either the `thingId` does not conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id))
- or the JSON was invalid or was not a JSON object.
+ The request could not be completed. Possible reasons:
+ * the `thingId` does not conform to the namespaced entity ID notation (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
+ * the JSON body of the feature to be created/modified is invalid
content:
application/json:
schema:
@@ -1225,14 +1450,17 @@
'403':
description: |-
- The request could not be completed as the caller had insufficient permissions. For modifying all features of an existing Thing `WRITE` permission is required.
+ The request could not be completed. Possible reasons:
+
+ * the caller has insufficient permissions.
+ For modifying all features of an existing thing, `WRITE` permission is required.
content:
application/json:
schema:
$ref: '#/components/schemas/AdvancedError'
'404':
description: |-
- The request could not be completed. The Thing with the given ID was
+ The request could not be completed. The thing with the given ID was
not found.
content:
application/json:
@@ -1247,29 +1475,62 @@
application/json:
schema:
$ref: '#/components/schemas/Features'
- example: {}
+ example: {
+ "coffee-brewer": {
+ "properties": {
+ "definition": [ "com.acme:coffeebrewer:0.1.0" ],
+ "brewed-coffees": 0
+ }
+ },
+ "water-tank": {
+ "properties": {
+ "configuration": {
+ "smartMode": true,
+ "brewingTemp": 87,
+ "tempToHold": 44,
+ "timeoutSeconds": 6000
+ },
+ "status": {
+ "waterAmount": 731,
+ "temperature": 44
+ }
+ }
+ }
+ }
description: |-
- JSON object of the Features to be modified at once. It can be also
- `null` or an empty object `{}` (all features cleared).
+ JSON object of all features to be modified at once. Consider that the value has to be a JSON object or null.
+
+ Examples:
+ * an empty object: {} - would just delete all old features
+ * an empty feature: { "featureId": {} } - We strongly recommend to use a restricted set of characters
+ for the `featureId`, as it might be needed for the (URL) path later.
+
+ Currently these identifiers should follow the pattern: [_a-zA-Z][_a-zA-Z0-9-]*
+
+ * a nested object with multiple features as shown in the example value field
+
required: true
delete:
- summary: Delete all Features of a specific Thing
+ summary: Delete all features of a specific thing
description: |-
- Deletes all features of the Thing identified by the `thingId` path
+ Deletes all features of the thing identified by the `thingId` path
parameter.
tags:
- Features
parameters:
- $ref: '#/components/parameters/thingIdPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/requestedAcksParam'
+ - $ref: '#/components/parameters/timeoutParam'
+ - $ref: '#/components/parameters/responseRequiredParam'
responses:
'204':
- description: The Features were successfully deleted.
+ description: The features were successfully deleted.
'400':
description: |-
- The request could not be completed. The `thingId` does not conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
+ The request could not be completed. Possible reasons:
+ * the `thingId` does not conform to the namespaced entity ID notation (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
content:
application/json:
schema:
@@ -1282,15 +1543,17 @@
$ref: '#/components/schemas/AdvancedError'
'403':
description: |-
- The request could not be completed as the caller had insufficient permissions. For deleting all features of an existing Thing `WRITE` permission is required.
+ The request could not be completed. Possible reasons:
+ * the caller has insufficient permissions.
+ For deleting all features of an existing thing, `WRITE` permission is required.
content:
application/json:
schema:
$ref: '#/components/schemas/AdvancedError'
'404':
description: |-
- The request could not be completed. The Thing with the given ID was
- not found or the Features have not been defined.
+ The request could not be completed. The thing with the given ID was
+ not found or the features have not been defined.
content:
application/json:
schema:
@@ -1299,21 +1562,22 @@
$ref: '#/components/responses/preconditionFailed'
'/things/{thingId}/features/{featureId}':
get:
- summary: Retrieve a specific Feature of a specific Thing
+ summary: Retrieve a specific feature of a specific thing
description: |-
- Returns a specific Feature identified by the `featureId` path parameter
- of the Thing identified by the `thingId` path parameter.
+ Returns a specific feature identified by the `featureId` path parameter
+ of the thing identified by the `thingId` path parameter.
tags:
- Features
parameters:
- $ref: '#/components/parameters/thingIdPathParam'
- $ref: '#/components/parameters/featureIdPathPathParam'
- $ref: '#/components/parameters/featureFieldsQueryParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/timeoutParam'
responses:
'200':
- description: The Feature was successfully retrieved.
+ description: The feature was successfully retrieved.
headers:
ETag:
description: |-
@@ -1329,9 +1593,9 @@
$ref: '#/components/responses/notModified'
'400':
description: |-
- The request could not be completed. Either the `thingId` does not conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id))
- or at least one of the defined query parameters was invalid.
+ The request could not be completed. Possible reasons:
+ * the `thingId` does not conform to the namespaced entity ID notation (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
+ * at least one of the defined query parameters is invalid.
content:
application/json:
schema:
@@ -1345,8 +1609,8 @@
'404':
description: |-
- The request could not be completed. The Thing with the given ID or
- the Feature with the specified `featureId` was not found.
+ The request could not be completed. The thing with the given ID or
+ the feature with the specified `featureId` was not found.
content:
application/json:
schema:
@@ -1354,20 +1618,41 @@
'412':
$ref: '#/components/responses/preconditionFailed'
put:
- summary: Create or modify a specific Feature of a specific Thing
+ summary: Create or modify a specific feature of a specific thing
description: |-
- Create or modify a specific Feature identified by the `featureId` path
- parameter of the Thing identified by the `thingId` path parameter.
+ Create or modify a specific feature identified by the `featureId` path
+ parameter of the thing identified by the `thingId` path parameter.
+
+ ### Create feature
+ If the feature ID is new, the feature and all content from the JSON body will be created
+
+ ### Update feature
+ If the feature ID is used already in this thing, the feature will be overwrittern
+ with the content from the JSON body.
+
+ Example: Set the `featureId` to **coffee-brewer** and all properties in the body part.
+
+ ```
+ {
+ "definition": ["com.acme:coffeebrewer:0.1.0"],
+ "properties": {
+ "brewed-coffees": 42
+ }
+ }
+ ```
tags:
- Features
parameters:
- $ref: '#/components/parameters/thingIdPathParam'
- $ref: '#/components/parameters/featureIdPathPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/requestedAcksParam'
+ - $ref: '#/components/parameters/timeoutParam'
+ - $ref: '#/components/parameters/responseRequiredParam'
responses:
'201':
- description: The Feature was successfully created.
+ description: The feature was successfully created.
headers:
ETag:
description: |-
@@ -1376,7 +1661,7 @@
schema:
type: string
Location:
- description: The location of the created Feature resource
+ description: The location of the created feature resource
schema:
type: string
content:
@@ -1384,7 +1669,7 @@
schema:
$ref: '#/components/schemas/Feature'
'204':
- description: The Feature was successfully modified.
+ description: The feature was successfully modified.
headers:
ETag:
description: |-
@@ -1394,9 +1679,9 @@
type: string
'400':
description: |-
- The request could not be completed. Either the `thingId` does not conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id))
- or the JSON of the Feature to be created was invalid.
+ The request could not be completed. Possible reasons:
+ * the `thingId` does not conform to the namespaced entity ID notation (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
+ * the JSON body of the feature to be created/modified is invalid
content:
application/json:
schema:
@@ -1410,14 +1695,17 @@
'403':
description: |-
- The request could not be completed as the caller had insufficient permissions. For modifying a single feature of an existing Thing `WRITE` permission is required.
+ The request could not be completed. Possible reasons:
+
+ * the caller has insufficient permissions.
+ For modifying a single feature of an existing thing, `WRITE` permission is required.
content:
application/json:
schema:
$ref: '#/components/schemas/AdvancedError'
'404':
description: |-
- The request could not be completed. The Thing with the given ID was
+ The request could not be completed. The thing with the given ID was
not found.
content:
application/json:
@@ -1432,30 +1720,43 @@
application/json:
schema:
$ref: '#/components/schemas/Feature'
- example: {}
+ example: {
+ "definition": [ "com.acme:coffeemaker:0.1.0", "com.acme:coffeemaker:1.1.0" ],
+ "properties": {
+ "connected": true,
+ "brewed-coffees": 0
+ }
+ }
description: |-
- JSON representation of the Feature to be created/modified. It can also
- be `null` or an empty object `{}`.
+ JSON representation of the feature to be created/modified.
+ Consider that the value has to be a JSON object or null.
+
+ Examples:
+ * an empty object: {} - would just create the featureID but would delete all content of the feature
+ * a nested object with multiple model definitions and multiple properties as shown in the example value field
required: true
delete:
- summary: Delete a specific Feature of a specific Thing
+ summary: Delete a specific feature of a specific thing
description: |-
- Deletes a specific Feature identified by the `featureId` path parameter
- of the Thing identified by the `thingId` path parameter.
+ Deletes a specific feature identified by the `featureId` path parameter
+ of the thing identified by the `thingId` path parameter.
tags:
- Features
parameters:
- $ref: '#/components/parameters/thingIdPathParam'
- $ref: '#/components/parameters/featureIdPathPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/requestedAcksParam'
+ - $ref: '#/components/parameters/timeoutParam'
+ - $ref: '#/components/parameters/responseRequiredParam'
responses:
'204':
- description: The Feature was successfully deleted.
+ description: The feature was successfully deleted.
'400':
description: |-
- The request could not be completed. The `thingId` does not conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
+ The request could not be completed. Possible reasons:
+ * the `thingId` does not conform to the namespaced entity ID notation (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
content:
application/json:
schema:
@@ -1468,15 +1769,18 @@
$ref: '#/components/schemas/AdvancedError'
'403':
description: |-
- The request could not be completed as the caller had insufficient permissions. For deleting a single feature of an existing Thing `WRITE` permission is required.
+ The request could not be completed. Possible reasons:
+
+ * the caller has insufficient permissions.
+ For deleting a single feature of an existing thing, `WRITE` permission is required.
content:
application/json:
schema:
$ref: '#/components/schemas/AdvancedError'
'404':
description: |-
- The request could not be completed. The Thing with the given ID or
- the Feature at the specified path was not found.
+ The request could not be completed. The thing with the given ID or
+ the feature at the specified path was not found.
content:
application/json:
schema:
@@ -1485,17 +1789,18 @@
$ref: '#/components/responses/preconditionFailed'
'/things/{thingId}/features/{featureId}/definition':
get:
- summary: List the definition of a Feature
+ summary: List the definition of a feature
description: |-
- Returns the complete definition of the Feature identified by the `thingId` and
+ Returns the complete definition field of the feature identified by the `thingId` and
`featureId` path parameter.
tags:
- Features
parameters:
- $ref: '#/components/parameters/thingIdPathParam'
- $ref: '#/components/parameters/featureIdPathPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/timeoutParam'
responses:
'200':
description: The definition was successfully retrieved.
@@ -1514,9 +1819,9 @@
$ref: '#/components/responses/notModified'
'400':
description: |-
- The request could not be completed. Either the `thingId` does not conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id))
- or at least one of the defined query parameters was invalid.
+ The request could not be completed. Possible reasons:
+ * the `thingId` does not conform to the namespaced entity ID notation (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
+ * at least one of the defined query parameters is invalid.
content:
application/json:
schema:
@@ -1529,8 +1834,8 @@
$ref: '#/components/schemas/AdvancedError'
'404':
description: |-
- The request could not be completed. The specified Feature has no
- definition or the Thing with the specified `thingId` or the Feature
+ The request could not be completed. The specified feature has no
+ definition or the thing with the specified `thingId` or the feature
with `featureId` was not found.
content:
application/json:
@@ -1539,18 +1844,22 @@
'412':
$ref: '#/components/responses/preconditionFailed'
put:
- summary: Create or update the definition of a Feature
+ summary: Create or update the definition of a feature
description: |-
- Create or update the complete definition of a Feature identified by the `thingId`
- and `featureId` path parameter at once. The definition will be replaced
- by the request body's JSON array.
+ Create or update the complete definition of a feature identified by the `thingId`
+ and `featureId` path parameter.
+
+ The definition field will be overwritten with the JSON array set in the request body
tags:
- Features
parameters:
- $ref: '#/components/parameters/thingIdPathParam'
- $ref: '#/components/parameters/featureIdPathPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/requestedAcksParam'
+ - $ref: '#/components/parameters/timeoutParam'
+ - $ref: '#/components/parameters/responseRequiredParam'
responses:
'201':
description: The definition was successfully created.
@@ -1580,9 +1889,9 @@
type: string
'400':
description: |-
- The request could not be completed. Either the `thingId` does not conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id))
- or the JSON was invalid.
+ The request could not be completed. Possible reasons:
+ * the `thingId` does not conform to the namespaced entity ID notation (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
+ * the JSON body is invalid
content:
application/json:
schema:
@@ -1596,14 +1905,16 @@
'403':
description: |-
- The request could not be completed as the caller had insufficient permissions. For modifying the definition of an existing Feature `WRITE` permission is required.
+ The request could not be completed. Possible reasons:
+ * the caller has insufficient permissions.
+ For modifying the definition of an existing feature, `WRITE` permission is required.
content:
application/json:
schema:
$ref: '#/components/schemas/AdvancedError'
'404':
description: |-
- The request could not be completed. The Thing or the Feature with
+ The request could not be completed. The thing or the feature with
the given ID was not found.
content:
application/json:
@@ -1618,32 +1929,37 @@
application/json:
schema:
$ref: '#/components/schemas/FeatureDefinition'
- example: {}
+ example: [ "com.acme:coffeebrewer:0.1.0", "com.acme:coffeebrewer:1.0.0" ]
description: |-
JSON array of the complete definition to be updated. Consider that the
- value has to be a JSON array or `null`. The content of the JSON array
+ value has to be a JSON array or `null`.
+
+ The content of the JSON array
are strings in the format `"namespace:name:version"` which is
enforced.
required: true
delete:
- summary: Delete the definition of a Feature
+ summary: Delete the definition of a feature
description: |-
- Deletes the complete definition of the Feature identified by the `thingId` and
+ Deletes the complete definition of the feature identified by the `thingId` and
`featureId` path parameter.
tags:
- Features
parameters:
- $ref: '#/components/parameters/thingIdPathParam'
- $ref: '#/components/parameters/featureIdPathPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/requestedAcksParam'
+ - $ref: '#/components/parameters/timeoutParam'
+ - $ref: '#/components/parameters/responseRequiredParam'
responses:
'204':
description: The definition was successfully deleted.
'400':
description: |-
- The request could not be completed. The `thingId` does not conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
+ The request could not be completed. Possible reasons:
+ * the `thingId` does not conform to the namespaced entity ID notation (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
content:
application/json:
schema:
@@ -1656,15 +1972,18 @@
$ref: '#/components/schemas/AdvancedError'
'403':
description: |-
- The request could not be completed as the caller had insufficient permissions. For deleting the definition of an existing Feature `WRITE` permission is required.
+ The request could not be completed. Possible reasons:
+
+ * the caller has insufficient permissions.
+ For deleting the definition of an existing feature, `WRITE` permission is required.
content:
application/json:
schema:
$ref: '#/components/schemas/AdvancedError'
'404':
description: |-
- The request could not be completed. The specified Feature has no
- definition or the Thing with the specified `thingId` or the Feature
+ The request could not be completed. The specified feature has no
+ definition or the thing with the specified `thingId` or the feature
with `featureId` was not found.
content:
application/json:
@@ -1674,9 +1993,9 @@
$ref: '#/components/responses/preconditionFailed'
'/things/{thingId}/features/{featureId}/properties':
get:
- summary: List all Properties of a Feature
+ summary: List all properties of a feature
description: |-
- Returns all Properties of the Feature identified by the `thingId` and
+ Returns all properties of the feature identified by the `thingId` and
`featureId` path parameter.
tags:
- Features
@@ -1684,11 +2003,12 @@
- $ref: '#/components/parameters/thingIdPathParam'
- $ref: '#/components/parameters/featureIdPathPathParam'
- $ref: '#/components/parameters/propertiesFieldsQueryParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/timeoutParam'
responses:
'200':
- description: The Properties were successfully retrieved.
+ description: The properties were successfully retrieved.
headers:
ETag:
description: |-
@@ -1704,9 +2024,9 @@
$ref: '#/components/responses/notModified'
'400':
description: |-
- The request could not be completed. Either the `thingId` does not conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id))
- or at least one of the defined query parameters was invalid.
+ The request could not be completed. Possible reasons:
+ * the `thingId` does not conform to the namespaced entity ID notation (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
+ * at least one of the defined query parameters is invalid.
content:
application/json:
schema:
@@ -1720,8 +2040,8 @@
'404':
description: |-
- The request could not be completed. The specified Feature has no
- Properties or the Thing with the specified `thingId` or the Feature
+ The request could not be completed. The specified feature has no
+ properties or the thing with the specified `thingId` or the feature
with `featureId` was not found.
content:
application/json:
@@ -1730,21 +2050,25 @@
'412':
$ref: '#/components/responses/preconditionFailed'
put:
- summary: Create or update all Properties of a Feature at once
+ summary: Create or update all properties of a feature at once
description: |-
- Create or update the Properties of a Feature identified by the `thingId`
- and `featureId` path parameter at once. The Properties will be replaced
- by the request body's JSON.
+ Create or update the properties of a feature identified by the `thingId`
+ and `featureId` path parameter.
+
+ The properties will be overwritten with the JSON content from the request body.
tags:
- Features
parameters:
- $ref: '#/components/parameters/thingIdPathParam'
- $ref: '#/components/parameters/featureIdPathPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/requestedAcksParam'
+ - $ref: '#/components/parameters/timeoutParam'
+ - $ref: '#/components/parameters/responseRequiredParam'
responses:
'201':
- description: The Properties were successfully created.
+ description: The properties were successfully created.
headers:
ETag:
description: |-
@@ -1757,7 +2081,7 @@
schema:
$ref: '#/components/schemas/FeatureProperties'
'204':
- description: The Properties were successfully updated.
+ description: The properties were successfully updated.
headers:
ETag:
description: |-
@@ -1767,9 +2091,9 @@
type: string
'400':
description: |-
- The request could not be completed. Either the `thingId` does not conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id))
- or the JSON was invalid.
+ The request could not be completed. Possible reasons:
+ * the `thingId` does not conform to the namespaced entity ID notation (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
+ * the JSON body of the feature properties to be created/modified is invalid
content:
application/json:
schema:
@@ -1783,14 +2107,17 @@
'403':
description: |-
- The request could not be completed as the caller had insufficient permissions. For modifying the Properties of an existing Feature `WRITE` permission is required.
+ The request could not be completed. Possible reasons:
+
+ * the caller has insufficient permissions.
+ For modifying the properties of an existing feature, `WRITE` permission is required.
content:
application/json:
schema:
$ref: '#/components/schemas/AdvancedError'
'404':
description: |-
- The request could not be completed. The Thing or the Feature with
+ The request could not be completed. The thing or the feature with
the given ID was not found.
content:
application/json:
@@ -1805,32 +2132,49 @@
application/json:
schema:
$ref: '#/components/schemas/FeatureProperties'
- example: {}
+ example: {
+ "configuration": {
+ "smartMode": true,
+ "brewingTemp": 87,
+ "tempToHold": 44,
+ "timeoutSeconds": 6000
+ },
+ "status": {
+ "waterAmount": 731,
+ "temperature": 44
+ }
+ }
description: |-
- JSON object of all Properties to be updated at once. Consider that the
- value has to be a JSON object or `null`. We strongly recommend to use
- a restricted set of characters for the key (identifier). Currently
- these identifiers should follow the pattern: [_a-zA-Z][_a-zA-Z0-9\-]*
+ JSON object of all properties to be updated at once.
+
+ Consider that the value has to be a JSON object or `null`. We strongly recommend to use
+ a restricted set of characters for the key (identifier).
+
+ Currently these identifiers should follow the pattern: [_a-zA-Z][_a-zA-Z0-9\-]*
+
required: true
delete:
- summary: Delete all Properties of a Feature
+ summary: Delete all properties of a feature
description: |-
- Deletes all Properties of the Feature identified by the `thingId` and
+ Deletes all properties of the feature identified by the `thingId` and
`featureId` path parameter.
tags:
- Features
parameters:
- $ref: '#/components/parameters/thingIdPathParam'
- $ref: '#/components/parameters/featureIdPathPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/requestedAcksParam'
+ - $ref: '#/components/parameters/timeoutParam'
+ - $ref: '#/components/parameters/responseRequiredParam'
responses:
'204':
- description: The Properties were successfully deleted.
+ description: The properties were successfully deleted.
'400':
description: |-
- The request could not be completed. The `thingId` does not conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
+ The request could not be completed. Possible reasons:
+ * the `thingId` does not conform to the namespaced entity ID notation (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
content:
application/json:
schema:
@@ -1843,15 +2187,18 @@
$ref: '#/components/schemas/AdvancedError'
'403':
description: |-
- The request could not be completed as the caller had insufficient permissions. For deleting the Properties of an existing Feature `WRITE` permission is required.
+ The request could not be completed. Possible reasons:
+
+ * the caller has insufficient permissions.
+ For deleting the properties of an existing feature, `WRITE` permission is required.
content:
application/json:
schema:
$ref: '#/components/schemas/AdvancedError'
'404':
description: |-
- The request could not be completed. The specified Feature has no
- Properties or the Thing with the specified `thingId` or the Feature
+ The request could not be completed. The specified feature has no
+ properties or the thing with the specified `thingId` or the feature
with `featureId` was not found.
content:
application/json:
@@ -1861,24 +2208,30 @@
$ref: '#/components/responses/preconditionFailed'
'/things/{thingId}/features/{featureId}/properties/{propertyPath}':
get:
- summary: Retrieve a specific Property of a Feature
+ summary: Retrieve a specific property of a feature
description: |-
- Returns the Property of the Feature identified by the `thingId` and
- `featureId` path parameter. The Property (JSON) can be referenced
- hierarchically by applying JSON Pointer notation (RFC-6901), e.g.:
- `/things/{thingId}/features/{featureId}/properties/location/latitude` in
- order to retrieve the `latitude` field of an `location` Property.
+ Returns the a specific property path of the feature identified by the `thingId` and
+ `featureId` path parameter.
+
+ The property (JSON) can be referenced
+ hierarchically, by applying JSON Pointer notation (RFC-6901)
+
+ ### Example
+ To retrieve the value of the `brewingTemp` in the `water-tank` of our coffeemaker example the full path is:
+
+ `/things/{thingId}/features/water-tank/properties/configuration/brewingTemp`
tags:
- Features
parameters:
- $ref: '#/components/parameters/thingIdPathParam'
- $ref: '#/components/parameters/featureIdPathPathParam'
- $ref: '#/components/parameters/propertyPathPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/timeoutParam'
responses:
'200':
- description: The Property was successfully retrieved.
+ description: The property was successfully retrieved.
headers:
ETag:
description: |-
@@ -1890,8 +2243,8 @@
$ref: '#/components/responses/notModified'
'400':
description: |-
- The request could not be completed. The `thingId` does not conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
+ The request could not be completed. Possible reasons:
+ * the `thingId` does not conform to the namespaced entity ID notation (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
content:
application/json:
schema:
@@ -1905,8 +2258,8 @@
'404':
description: |-
- The request could not be completed. The specified Property or the
- Thing with the specified `thingId` or the Feature with `featureId`
+ The request could not be completed. The specified property or the
+ thing with the specified `thingId` or the feature with `featureId`
was not found.
content:
application/json:
@@ -1915,26 +2268,36 @@
'412':
$ref: '#/components/responses/preconditionFailed'
put:
- summary: Create or update a specific Property of a Feature
+ summary: Create or update a specific property of a feature
description: |-
- Create or update a specific Property of a Feature identified by the
- `thingId` and `featureId` path parameter. The Property will be created
- if it doesn't exist or else updated. The Property (JSON) can be
- referenced hierarchically by applying JSON Pointer notation (RFC-6901),
- e.g.:
- `/things/{thingId}/features/{featureId}/properties/location/latitude` in
- order to create/update the `latitude` field of an `location` object.
+ Create or update a specific property of a feature identified by the
+ `thingId` and `featureId` path parameter.
+
+ The property will be created
+ if it doesn't exist or else updated.
+
+ The property (JSON) can be
+ referenced hierarchically, by applying JSON Pointer notation (RFC-6901),
+
+ ### Example
+ To set the value of the brewingTemp in the water-tank of our coffeemaker example the full path is:
+
+ `/things/{thingId}/features/water-tank/properties/configuration/brewingTemp`
+
tags:
- Features
parameters:
- $ref: '#/components/parameters/thingIdPathParam'
- $ref: '#/components/parameters/featureIdPathPathParam'
- $ref: '#/components/parameters/propertyPathPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/requestedAcksParam'
+ - $ref: '#/components/parameters/timeoutParam'
+ - $ref: '#/components/parameters/responseRequiredParam'
responses:
'201':
- description: The Property was successfully created.
+ description: The property was successfully created.
headers:
ETag:
description: |-
@@ -1943,7 +2306,7 @@
schema:
type: string
'204':
- description: The Property was successfully updated.
+ description: The property was successfully updated.
headers:
ETag:
description: |-
@@ -1953,9 +2316,10 @@
type: string
'400':
description: |-
- The request could not be completed. Either the `thingId` does not conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id))
- or the JSON was invalid.
+ The request could not be completed. Possible reasons:
+ * the `thingId` does not conform to the namespaced entity ID notation (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
+ * the JSON body is invalid
+
content:
application/json:
schema:
@@ -1969,14 +2333,17 @@
'403':
description: |-
- The request could not be completed as the caller had insufficient permissions. For creating/updating a Property of an existing Feature `WRITE` permission is required.
+ The request could not be completed. Possible reasons:
+
+ * the caller has insufficient permissions.
+ For creating/updating a property of an existing feature, `WRITE` permission is required.
content:
application/json:
schema:
$ref: '#/components/schemas/AdvancedError'
'404':
description: |-
- The request could not be completed. The Thing or the Feature with
+ The request could not be completed. The thing or the feature with
the given ID was not found.
content:
application/json:
@@ -1989,28 +2356,36 @@
requestBody:
$ref: '#/components/requestBodies/Value'
delete:
- summary: Delete a specific Property of a Feature
+ summary: Delete a specific property of a feature
description: |-
- Deletes a specific Property of the Feature identified by the `thingId`
- and `featureId` path parameter. The Property (JSON) can be referenced
- hierarchically by applying JSON Pointer notation (RFC-6901), e.g.:
- `/things/{thingId}/features/{featureId}/properties/location/latitude` in
- order to delete the `latitude` field of an `location` Property.
+ Deletes a specific property of the feature identified by the `thingId`
+ and `featureId` path parameter.
+
+ The property (JSON) can be referenced
+ hierarchically, by applying JSON Pointer notation (RFC-6901)
+
+ ### Example
+ To delete the value of the brewingTemp in the water-tank of our coffeemaker example the full path is:
+
+ `/things/{thingId}/features/water-tank/properties/configuration/brewingTemp`
tags:
- Features
parameters:
- $ref: '#/components/parameters/thingIdPathParam'
- $ref: '#/components/parameters/featureIdPathPathParam'
- $ref: '#/components/parameters/propertyPathPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/requestedAcksParam'
+ - $ref: '#/components/parameters/timeoutParam'
+ - $ref: '#/components/parameters/responseRequiredParam'
responses:
'204':
- description: The Property was successfully deleted.
+ description: The property was successfully deleted.
'400':
description: |-
- The request could not be completed. The `thingId` does not conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
+ The request could not be completed. Possible reasons:
+ * the `thingId` does not conform to the namespaced entity ID notation (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
content:
application/json:
schema:
@@ -2024,8 +2399,8 @@
'404':
description: |-
- The request could not be completed. The specified Property or the
- Thing with the specified `thingId` or the Feature with `featureId`
+ The request could not be completed. The specified property or the
+ thing with the specified `thingId` or the feature with `featureId`
was not found.
content:
application/json:
@@ -2038,22 +2413,36 @@
###
'/things/{thingId}/inbox/claim':
post:
- summary: Initiates claiming a specific Thing in order to gain access
+ summary: Initiates claiming a specific thing in order to gain access
description: |-
- Send a Claim message to the Thing identified by the `thingId` path
- parameter in order to gain access to it. The Claim message is forwarded
- together with the request body and `Content-Type` header to client(s)
- which registered for Claim messages of the specific Thing.
+ ### Why
+ A claiming process may enable an end-user to claim things and proof ownership thereof.
+ Such a process is initially triggered via a claim message.
+ This message can be sent to the things service with the HTTP API or the things-client.
+ ### How
+ At this resource you can send a "claim" message to the thing identified
+ by the `thingId` path parameter in order to gain access to it. The "claim" message is forwarded
+ together with the request body and `Content-Type` header to client(s)
+ which registered for Claim messages of the specific thing.
The decision whether to grant access (by setting permissions) is
- completely up to the client(s) which handle the Claim message.
+ completely up to the client(s) which handle the "claim" message.
-
- The HTTP request blocks until a response to the issued Claim message is
+ The HTTP request blocks until a response to the issued "claim" message is
available or until the `timeout` is expired. If many clients respond to
the issued message, the first response will complete the HTTP request.
- No special permissions are required to issue a Claim message.
+
+ ### Who
+ No special permission is required to issue a claim message.
+
+ ### Example
+ See [Claiming](https://www.eclipse.org/ditto/protocol-specification-things-messages.html#sending-and-handling-claim-messages) concept in detail and example in GitHub.
+ However, in that scenario, the policy should grant you READ and WRITE permission on
+ the "message:/" resource in order to be able to send the message and read the response.
+ Further, the things-client which handles the "claim" message, needs permission to change the policy itself
+ (i.e. READ and WRITE permission on the "policy:/" resource).
+
tags:
- Messages
parameters:
@@ -2073,9 +2462,9 @@
by the recipient.
'400':
description: |-
- The request could not be completed. Either the `thingId` does not conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id))
- or at least one of the defined path parameters was invalid.
+ The request could not be completed. Possible reasons:
+ * the `thingId` does not conform to the namespaced entity ID notation (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
+ * at least one of the defined path parameters is invalid
content:
application/json:
schema:
@@ -2101,14 +2490,17 @@
$ref: '#/components/requestBodies/Payload'
'/things/{thingId}/inbox/messages/{messageSubject}':
post:
- summary: Send a message TO a specific Thing
+ summary: Send a message TO a specific thing
description: |-
- Send a message with the subject `messageSubject` `TO` the Thing
+ ### Why
+ A message can be sent to a thing or one of its features in order to invoke an operation on the device.
+
+ ### How
+ Send a message with a `messageSubject` **to** the thing
identified by the `thingId` path parameter. The request body contains
- the message payload and the `Content-Type` header defines its type. The
- API does not provide any kind of acknowledgement that the message was
- received by the Thing. In order to send a message, the user needs `WRITE`
- permission at the Thing level.
+ the message payload and the `Content-Type` header defines its type.
+
+ The API does not provide any kind of acknowledgement that the thing has received the message.
The HTTP request blocks until a response to the message is available
or until the `timeout` is expired. If many clients respond to
@@ -2116,6 +2508,20 @@
In order to handle the message in a fire and forget manner, add
a query-parameter `timeout=0` to the request.
+
+ ### Who
+ You will need `WRITE` permission on the root "message:/" resource, or at least
+ the resource `message:/inbox/messages/messageSubject`. The receiving device needs `READ` permission on the resource.
+ Such permission is managed within the policy which controls the access on the thing.
+
+ ### Example
+ Given you have a "coffemaker" thing as shown in the examples for the `things` resources.
+ The `messageSubject` understood by such a device would be "makeCoffee".
+
+ Further, as in our example the "brewed-coffees" counter would increase as a response, you would need `WRITE`
+ permission for the things resource, at least at the respective path
+
+ `/things/{thingId}/features/coffee-brewer/properties/brewed-coffees`
tags:
- Messages
parameters:
@@ -2125,12 +2531,12 @@
responses:
'202':
description: |-
- The message was sent but not necessarily received by the Thing (fire and forget).
+ The message was sent but not necessarily received by the thing (fire and forget).
'400':
description: |-
- The request could not be completed. Either the `thingId` does not conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id))
- or at least one of the defined path parameters was invalid.
+ The request could not be completed. Possible reasons:
+ * the `thingId` does not conform to the namespaced entity ID notation (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
+ * at least one of the defined path parameters is invalid
content:
application/json:
schema:
@@ -2143,7 +2549,10 @@
$ref: '#/components/schemas/AdvancedError'
'403':
description: |-
- The request could not be completed as the caller does not have `WRITE` permission on the resource message:/inbox/messages/`messageSubject`.
+ The request could not be completed. Possible reasons:
+
+ * the caller has insufficient permissions.
+ You need `WRITE` permission on the resource `message:/inbox/messages/{messageSubject}`.
content:
application/json:
schema:
@@ -2154,13 +2563,11 @@
$ref: '#/components/requestBodies/Payload'
'/things/{thingId}/outbox/messages/{messageSubject}':
post:
- summary: Send a message FROM a specific Thing
+ summary: Send a message FROM a specific thing
description: |-
- Send a message with the subject `messageSubject` `FROM` the Thing
+ Send a message with the subject `messageSubject` **from** the thing
identified by the `thingId` path parameter. The request body contains
the message payload and the `Content-Type` header defines its type.
- In order to send a message, the user needs `WRITE` permission at the
- Thing level.
The HTTP request blocks until a response to the message is available
or until the `timeout` is expired. If many clients respond to
@@ -2168,6 +2575,11 @@
In order to handle the message in a fire and forget manner, add
a query-parameter `timeout=0` to the request.
+
+ ### Who
+ You will need `WRITE` permission on the root "message:/" resource, or at least
+ the resource `message:/outbox/messages/messageSubject`.
+ Such permission is managed within the policy which controls the access on the thing.
tags:
- Messages
parameters:
@@ -2179,9 +2591,9 @@
description: The message was sent (fire and forget).
'400':
description: |-
- The request could not be completed. Either the `thingId` does not conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id))
- or at least one of the defined path parameters was invalid.
+ The request could not be completed. Possible reasons:
+ * the `thingId` does not conform to the namespaced entity ID notation (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
+ * at least one of the defined path parameters is invalid.
content:
application/json:
schema:
@@ -2194,7 +2606,10 @@
$ref: '#/components/schemas/AdvancedError'
'403':
description: |-
- The request could not be completed as the caller does not have `WRITE` permission on the resource message:/outbox/messages/`messageSubject`.
+ The request could not be completed. Possible reasons:
+
+ * the caller has insufficient permissions.
+ You need `WRITE` permission on the resource `message:/outbox/messages/{messageSubject}`.
content:
application/json:
schema:
@@ -2205,13 +2620,13 @@
$ref: '#/components/requestBodies/Payload'
'/things/{thingId}/features/{featureId}/inbox/messages/{messageSubject}':
post:
- summary: Send a message TO a specific Feature of a specific Thing
+ summary: Send a message TO a specific feature of a specific thing
description: |-
- Send a message with the subject `messageSubject` `TO` the Feature
+ Send a message with the subject `messageSubject` **to** the feature
specified by the `featureId` and `thingId` path parameter. The request
body contains the message payload and the `Content-Type` header defines
its type. The API does not provide any kind of acknowledgement that the
- message was received by the Feature. In order to send a message, the user needs `WRITE` permission at the Thing level.
+ message was received by the feature.
The HTTP request blocks until a response to the message is available
or until the `timeout` is expired. If many clients respond to
@@ -2219,6 +2634,11 @@
In order to handle the message in a fire and forget manner, add
a query-parameter `timeout=0` to the request.
+
+ ### Who
+ You will need `WRITE` permission on the root "message:/" resource, or at least
+ the resource `message:/features/featureId/inbox/messages/messageSubject`. The receiving device needs `READ` permission on the resource.
+ Such permission is managed within the policy which controls the access on the thing.
tags:
- Messages
parameters:
@@ -2229,13 +2649,13 @@
responses:
'202':
description: |-
- The message was sent but not necessarily received by the Feature
+ The message was sent but not necessarily received by the feature
(fire and forget).
'400':
description: |-
- The request could not be completed. Either the `thingId` does not conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id))
- or at least one of the defined path parameters was invalid.
+ The request could not be completed. Possible reasons:
+ * the `thingId` does not conform to the namespaced entity ID notation (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
+ * at least one of the defined path parameters is invalid.
content:
application/json:
schema:
@@ -2248,7 +2668,10 @@
$ref: '#/components/schemas/AdvancedError'
'403':
description: |-
- The request could not be completed as the caller does not have `WRITE` permission on the resource message:/features/`featureId`/inbox/messages/`messageSubject`.
+ The request could not be completed. Possible reasons:
+
+ * the caller has insufficient permissions.
+ You need `WRITE` permission on the resource `message:/features/{featureId}/inbox/messages/{messageSubject}`.
content:
application/json:
schema:
@@ -2259,13 +2682,12 @@
$ref: '#/components/requestBodies/Payload'
'/things/{thingId}/features/{featureId}/outbox/messages/{messageSubject}':
post:
- summary: Send a message FROM a specific Feature of a specific Thing
+ summary: Send a message FROM a specific feature of a specific thing
description: |-
- Send a message with the subject `messageSubject` `FROM` the Feature
+ Send a message with the subject `messageSubject` **from** the feature
specified by the `featureId` and `thingId` path parameter. The request
body contains the message payload and the `Content-Type` header defines
- its type. In order to send a message, the user needs `WRITE` permission
- at the Thing level.
+ its type.
The HTTP request blocks until a response to the message is available
or until the `timeout` is expired. If many clients respond to
@@ -2273,6 +2695,11 @@
In order to handle the message in a fire and forget manner, add
a query-parameter `timeout=0` to the request.
+
+ ### Who
+ You will need `WRITE` permission on the root "message:/" resource, or at least
+ the resource `message:/features/featureId/outbox/messages/messageSubject`.
+ Such permission is managed within the policy which controls the access on the thing.
tags:
- Messages
parameters:
@@ -2285,9 +2712,9 @@
description: The message was sent (fire and forget).
'400':
description: |-
- The request could not be completed. Either the `thingId` does not conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id))
- or at least one of the defined path parameters was invalid.
+ The request could not be completed. Possible reasons:
+ * the `thingId` does not conform to the namespaced entity ID notation (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
+ * at least one of the defined path parameters is valid.
content:
application/json:
schema:
@@ -2300,7 +2727,10 @@
$ref: '#/components/schemas/AdvancedError'
'403':
description: |-
- The request could not be completed as the caller does not have `WRITE` permission on the resource message:/features/`featureId`/outbox/messages/`messageSubject`.
+ The request could not be completed. Possible reasons:
+
+ * the caller has insufficient permissions.
+ You need `WRITE` permission on the resource `message:/features/{featureId}/outbox/messages/{messageSubject}`.
content:
application/json:
schema:
@@ -2314,22 +2744,24 @@
###
'/policies/{policyId}':
get:
- summary: Retrieve a specific Policy
+ summary: Retrieve a specific policy
description: |-
- Returns the Policy identified by the `policyId` path parameter. The
- response contains the Policy as JSON object consisting of Policy
- Entries.
+ Returns the complete policy identified by the `policyId` path parameter. The
+ response contains the policy as JSON object.
+
+ Tip: If you don't know the policy ID, request it via GET ​/things​/{thingId}.
tags:
- Policies
parameters:
- $ref: '#/components/parameters/policyIdPathParam'
- $ref: '#/components/parameters/ifMatchHeaderParam'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/timeoutParam'
responses:
'200':
description: |-
The request successfully returned completed and returned is the
- Policy.
+ policy.
headers:
ETag:
description: |-
@@ -2345,8 +2777,9 @@
$ref: '#/components/responses/notModified'
'400':
description: |-
- The request could not be completed. The `policyId` does not conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
+ The request could not be completed. Possible reasons:
+
+ * the `policyId` does not conform to the namespaced entity ID notation (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id))
content:
application/json:
schema:
@@ -2360,7 +2793,7 @@
'404':
description: |-
- The request could not be completed. The Policy with the given ID was
+ The request could not be completed. The policy with the given ID was
not found in the context of the authenticated user.
content:
application/json:
@@ -2369,34 +2802,76 @@
'412':
$ref: '#/components/responses/preconditionFailed'
put:
- summary: Create or update a Policy with a specified ID
+ summary: Create or update a policy with a specified ID
description: |-
- Modify the complete Policy identified by the `policyId` path parameter. The `policyId` has to conform to the
- namespaced entity ID notation (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
+ Create or update the policy specified by the policyId path parameter.
+ * If you set a new policyId in the path, a new policy will be created.
+ * If you set an existing policyId in the path, the policy will be updated.
- #### Valid examples
+ ### Create a new policy
+ At the initial creation of a policy, at least one valid entry is required. However, you can create a full-fledged policy all at once.
- * `com.bosch.myproject:myPolicy1`
- * `mynamespace:myPolicy1`
+ Example: To create a policy for multiple coffee maker things,
+ which gives **yourself** all permissions on all resources, set the policyId in the path,
+ e.g. to "com.acme.coffeemaker:policy-01" and the body part, like in the following snippet.
- #### Invalid examples
+ ```
+ {
+ "entries": {
+ "DEFAULT": {
+ "subjects": {
+ "{{ request:subjectId }}": {
+ "type": "the creator"
+ }
+ },
+ "resources": {
+ "policy:/": {
+ "grant": [
+ "READ",
+ "WRITE"
+ ],
+ "revoke": []
+ },
+ "thing:/": {
+ "grant": [
+ "READ",
+ "WRITE"
+ ],
+ "revoke": []
+ },
+ "message:/": {
+ "grant": [
+ "READ",
+ "WRITE"
+ ],
+ "revoke": []
+ }
+ }
+ }
+ }
+ }
+ ```
- * `42:myFridge1`
- * `.foo:myFridge1`
- * `bar.:myFridge1`
+ ### Update an existing policy
+ For updating an existing policy, the authorized subject needs WRITE permission on the policy's root resource.
- The ID of a Policy can't be changed after creation. Any `policyId` specified in the request body is therefore
- ignored.
+ The ID of a policy cannot be changed after creation. Any `policyId` specified in the request body is therefore ignored.
+ ### Partially update an existing policy
+ Partial updates are not supported.
+
+ If you need to create or update a specific label, resource, or subject, please use the respective sub-resources.
tags:
- Policies
parameters:
- $ref: '#/components/parameters/policyIdPathParam'
- $ref: '#/components/parameters/ifMatchHeaderParam'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/timeoutParam'
+ - $ref: '#/components/parameters/responseRequiredParam'
responses:
'201':
- description: The Policy was successfully created.
+ description: The policy was successfully created.
headers:
ETag:
description: |-
@@ -2405,7 +2880,7 @@
schema:
type: string
Location:
- description: The location of the created Policy resource
+ description: The location of the created policy resource
schema:
type: string
content:
@@ -2413,7 +2888,7 @@
schema:
$ref: '#/components/schemas/Policy'
'204':
- description: The Policy was successfully updated.
+ description: The policy was successfully updated.
headers:
ETag:
description: |-
@@ -2423,9 +2898,10 @@
type: string
'400':
description: |-
- The request could not be completed. Either the `policyId` does not conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id))
- or the JSON was invalid, or no valid Policy JSON object.
+ The request could not be completed. Possible reasons:
+
+ * the `policyId` does not conform to the namespaced entity ID notation (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id))
+ * the JSON body of the policy to be created/modified is invalid
content:
application/json:
schema:
@@ -2439,14 +2915,18 @@
'403':
description: |-
- The request could not be completed as the caller had insufficient permissions. For modifying a complete Policy, `WRITE` permission on the resource `policy:/` is required without having any revoke.
+ The request could not be completed. Possible reasons:
+
+ * the caller has insufficient permissions.
+ You need `WRITE` permission on the root `policy:/` resource,
+ without any revoke in a deeper path of the policy resource.
content:
application/json:
schema:
$ref: '#/components/schemas/AdvancedError'
'404':
description: |-
- The request could not be completed. The Policy with the given ID was
+ The request could not be completed. The policy with the given ID was
not found in the context of the authenticated user.
content:
application/json:
@@ -2461,35 +2941,72 @@
application/json:
schema:
$ref: '#/components/schemas/Policy'
- example: {}
+ example: {
+ "entries": {
+ "DEFAULT": {
+ "subjects": {
+ "{{ request:subjectId }}": {
+ "type": "the creator"
+ }
+ },
+ "resources": {
+ "policy:/": {
+ "grant": [
+ "READ",
+ "WRITE"
+ ],
+ "revoke": []
+ },
+ "thing:/": {
+ "grant": [
+ "READ",
+ "WRITE"
+ ],
+ "revoke": []
+ },
+ "message:/": {
+ "grant": [
+ "READ",
+ "WRITE"
+ ],
+ "revoke": []
+ }
+ }
+ }
+ }
+ }
description: |-
- JSON representation of the Policy.
-
-
+ JSON representation of the policy.
Use the placeholder `{{ request:subjectId }}` in order to let the
backend insert the authenticated subjectId of the HTTP request.
required: true
delete:
- summary: Delete a specific Policy
+ summary: Delete a specific policy
description: |-
- Deletes the Policy identified by the `policyId` path parameter. Deleting
- a Policy does not implicitly delete other entities (e.g. Things) which
- use this Policy. Those have to be deleted in advance of deleting the
- Policy.
+ Deletes the policy identified by the `policyId` path parameter. Deleting
+ a policy does not implicitly delete other entities (e.g. things) which
+ use this policy.
+
+ Note: Delete the respective things **before** deleting the
+ policy, otherwise nobody has permission to read, update, or delete the things.
+ If you accidentally run into such a scenario, re-create the policy via
+ PUT `/policies/{policyId}`.
tags:
- Policies
parameters:
- $ref: '#/components/parameters/policyIdPathParam'
- $ref: '#/components/parameters/ifMatchHeaderParam'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/timeoutParam'
+ - $ref: '#/components/parameters/responseRequiredParam'
responses:
'204':
- description: The Policy was successfully deleted.
+ description: The policy was successfully deleted.
'400':
description: |-
- The request could not be completed. Either the `policyId` does not conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id))
- or the JSON was invalid, or no valid Policy JSON object.
+ The request could not be completed. Possible reasons:
+
+ * the `policyId` does not conform to the namespaced entity ID notation (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id))
content:
application/json:
schema:
@@ -2502,14 +3019,17 @@
$ref: '#/components/schemas/AdvancedError'
'403':
description: |-
- The request could not be completed as the caller had insufficient permissions. For deleting an existing Policy, `WRITE` permission on the resource `policy:/` is required without having any revoke.
+ The request could not be completed. Possible reasons:
+ * the caller has insufficient permissions.
+ You need `WRITE` permission on the root `policy:/` resource,
+ without any revoke in a deeper path of the policy resource.having any revoke.
content:
application/json:
schema:
$ref: '#/components/schemas/AdvancedError'
'404':
description: |-
- The request could not be completed. The Policy with the given ID was
+ The request could not be completed. The policy with the given ID was
not found in the context of the authenticated user.
content:
application/json:
@@ -2519,21 +3039,22 @@
$ref: '#/components/responses/preconditionFailed'
'/policies/{policyId}/entries':
get:
- summary: Retrieve the entries of a specific Policy
+ summary: Retrieve the entries of a specific policy
description: |-
- Returns the Policy entries of the Policy identified by the `policyId`
+ Returns all policy entries of the policy identified by the `policyId`
path parameter.
tags:
- Policies
parameters:
- $ref: '#/components/parameters/policyIdPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/timeoutParam'
responses:
'200':
description: |-
The request successfully returned completed and returned are the
- Policy entries.
+ policy entries.
headers:
ETag:
description: |-
@@ -2549,8 +3070,9 @@
$ref: '#/components/responses/notModified'
'400':
description: |-
- The request could not be completed. The `policyId` does not conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
+ The request could not be completed. Possible reasons:
+
+ * the `policyId` does not conform to the namespaced entity ID notation (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id))
content:
application/json:
schema:
@@ -2564,7 +3086,7 @@
'404':
description: |-
- The request could not be completed. The Policy with the given ID was
+ The request could not be completed. The policy with the given ID was
not found in the context of the authenticated user.
content:
application/json:
@@ -2573,19 +3095,24 @@
'412':
$ref: '#/components/responses/preconditionFailed'
put:
- summary: Modify the entries of a specific Policy
+ summary: Modify the entries of a specific policy
description: |-
- Modify the Policy entries of the Policy identified by the `policyId`
+ Modify the policy entries of the policy identified by the `policyId`
path parameter.
+
+ Note: Take care to not lock yourself out. Use the placeholder {{ request:subjectId }}
+ in order to let the backend insert the authenticated subjectId of the HTTP request.
tags:
- Policies
parameters:
- $ref: '#/components/parameters/policyIdPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/timeoutParam'
+ - $ref: '#/components/parameters/responseRequiredParam'
responses:
'204':
- description: The Policy entries were successfully updated.
+ description: The policy entries were successfully updated.
headers:
ETag:
description: |-
@@ -2595,9 +3122,10 @@
type: string
'400':
description: |-
- The request could not be completed. Either the `policyId` does not conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id))
- or the JSON was invalid, or no valid Policy entry JSON object.
+ The request could not be completed. Possible reasons:
+
+ * the `policyId` does not conform to the namespaced entity ID notation (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id))
+ * the JSON body of the policy to be created/modified is invalid
content:
application/json:
schema:
@@ -2611,14 +3139,18 @@
'403':
description: |-
- The request could not be completed as the caller had insufficient permissions. For modifying the Policy entries of an existing Policy, `WRITE` permission on the resource `policy:/entries` is required is required without having any revoke.
+ The request could not be completed. Possible reasons:
+
+ * the caller has insufficient permissions.
+ You need `WRITE` permission on the `policy:/entries` resource,
+ without any revoke in a deeper path of the policy resource.
content:
application/json:
schema:
$ref: '#/components/schemas/AdvancedError'
'404':
description: |-
- The request could not be completed. The Policy with the given ID was
+ The request could not be completed. The policy with the given ID was
not found in the context of the authenticated user.
content:
application/json:
@@ -2633,32 +3165,63 @@
application/json:
schema:
$ref: '#/components/schemas/PolicyEntries'
- example: {}
+ example: {
+ "DEFAULT": {
+ "subjects": {
+ "{{ request:subjectId }}": {
+ "type": "the creator"
+ }
+ },
+ "resources": {
+ "policy:/": {
+ "grant": [
+ "READ",
+ "WRITE"
+ ],
+ "revoke": []
+ },
+ "thing:/": {
+ "grant": [
+ "READ",
+ "WRITE"
+ ],
+ "revoke": []
+ },
+ "message:/": {
+ "grant": [
+ "READ",
+ "WRITE"
+ ],
+ "revoke": []
+ }
+ }
+ }
+ }
description: |-
- JSON representation of the Policy entries.
-
-
+ JSON representation of the policy entries.
Use the placeholder `{{ request:subjectId }}` in order to let the
backend insert the authenticated subjectId of the HTTP request.
required: true
'/policies/{policyId}/entries/{label}':
get:
- summary: Retrieve one Policy entry of a Policy for a specific label
+ summary: Retrieve the entries of a specific Label of a specific policy
description: |-
- Returns one Policy entry of the Policy identified by the `policyId` path
- parameter and for the label identified by the `label` path parameter.
+ Returns all entries (subjects, resources, etc.) of the policy identified by the `policyId` path
+ parameter, and by the `label` path parameter.
+ Example label: DEFAULT.
tags:
- Policies
parameters:
- $ref: '#/components/parameters/policyIdPathParam'
- $ref: '#/components/parameters/labelPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/timeoutParam'
responses:
'200':
description: |-
The request successfully returned completed and returned is the
- Policy entry.
+ policy entry.
headers:
ETag:
description: |-
@@ -2674,8 +3237,9 @@
$ref: '#/components/responses/notModified'
'400':
description: |-
- The request could not be completed. The `policyId` does not conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
+ The request could not be completed. Possible reasons:
+
+ * the `policyId` does not conform to the namespaced entity ID notation (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id))
content:
application/json:
schema:
@@ -2689,8 +3253,8 @@
'404':
description: |-
- The request could not be completed. The Policy with the given ID or
- the Policy entry was not found in the context of the authenticated
+ The request could not be completed. The policy with the given ID or
+ the policy entry was not found in the context of the authenticated
user.
content:
application/json:
@@ -2699,21 +3263,25 @@
'412':
$ref: '#/components/responses/preconditionFailed'
put:
- summary: Create or modify one Policy entry of a Policy for a specific label
+ summary: Create or modify the entries of a specific Label of a specific policy
description: |-
- Create or modify the Policy entry of the Policy identified by the
+ Create or modify the policy entry identified by the
`policyId` path parameter and with the label identified by the `label`
path parameter.
+ * If you specify a new label, the respective policy entry will be created
+ * If you specify an existig label, the respective policy entry will be updated
tags:
- Policies
parameters:
- $ref: '#/components/parameters/policyIdPathParam'
- $ref: '#/components/parameters/labelPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/timeoutParam'
+ - $ref: '#/components/parameters/responseRequiredParam'
responses:
'201':
- description: The Policy entry was successfully created.
+ description: The policy entry was successfully created.
headers:
ETag:
description: |-
@@ -2722,7 +3290,7 @@
schema:
type: string
Location:
- description: The location of the created Policy entry
+ description: The location of the created policy entry
schema:
type: string
content:
@@ -2730,7 +3298,7 @@
schema:
$ref: '#/components/schemas/PolicyEntry'
'204':
- description: The Policy entry was successfully updated.
+ description: The policy entry was successfully updated.
headers:
ETag:
description: |-
@@ -2740,9 +3308,10 @@
type: string
'400':
description: |-
- The request could not be completed. Either the `policyId` does not conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id))
- or the JSON was invalid, or no valid Policy entry JSON object.
+ The request could not be completed. Possible reasons:
+
+ * the `policyId` does not conform to the namespaced entity ID notation (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id))
+ * the JSON body of the policy entry to be created/modified is invalid
content:
application/json:
schema:
@@ -2756,14 +3325,18 @@
'403':
description: |-
- The request could not be completed as the caller had insufficient permissions. For modifying a Policy entry of an existing Policy, `WRITE` permission on the resource `policy:/entries/{label}` is required is required without having any revoke.
+ The request could not be completed. Possible reasons:
+
+ * the caller has insufficient permissions.
+ You need `WRITE` permission on the `policy:/entries/{label}` resource,
+ without any revoke in a deeper path of the policy resource.
content:
application/json:
schema:
$ref: '#/components/schemas/AdvancedError'
'404':
description: |-
- The request could not be completed. The Policy with the given ID was
+ The request could not be completed. The policy with the given ID was
not found in the context of the authenticated user.
content:
application/json:
@@ -2778,33 +3351,96 @@
application/json:
schema:
$ref: '#/components/schemas/PolicyEntry'
- example: {}
+ example: {
+ "subjects": {
+ "{{ request:subjectId }}": {
+ "type": "the creator"
+ }
+ },
+ "resources": {
+ "policy:/": {
+ "grant": [
+ "READ",
+ "WRITE"
+ ],
+ "revoke": []
+ },
+ "thing:/": {
+ "grant": [
+ "READ",
+ "WRITE"
+ ],
+ "revoke": []
+ },
+ "message:/": {
+ "grant": [
+ "READ",
+ "WRITE"
+ ],
+ "revoke": []
+ }
+ }
+ }
+
description: |-
- JSON representation of the Policy entry.
-
-
+ JSON representation of the policy entry.
Use the placeholder `{{ request:subjectId }}` in order to let the
backend insert the authenticated subjectId of the HTTP request.
+
+ ### Example
+ Given your policy "com.acme.coffeemaker:policy-01" only has the
+ DEFAULT entry, and you want to add a "Consumer" section which additionally allows USER-01
+ (managed within a Nginx reverse proxy) to
+ *read* the thing and to trigger a "makeCoffee" operation (i.e. POST such a message - see
+ POST /things/{thingId}/inbox/messages/{messageSubject}).
+
+ Set the label value to **Consumer** and the following request body:
+ ```
+ {
+ "subjects": {
+ "nginx:USER-01": {
+ "type": "pre authenticated user from nginx"
+ },
+ },
+ "resources": {
+ "thing:/": {
+ "grant": [
+ "READ"
+ ],
+ "revoke": []
+ },
+ "message:/": {
+ "grant": [
+ "WRITE"
+ ],
+ "revoke": []
+ }
+ }
+ }
+ ```
required: true
delete:
- summary: Delete one Policy entry of a Policy for a specific label
+ summary: Delete the entries of a specific Label of a specific policy
description: |-
- Deletes the Policy entry of the Policy identified by the `policyId` path
+ Deletes the entry of the policy identified by the `policyId` path
parameter and with the label identified by the `label` path parameter.
tags:
- Policies
parameters:
- $ref: '#/components/parameters/policyIdPathParam'
- $ref: '#/components/parameters/labelPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/timeoutParam'
+ - $ref: '#/components/parameters/responseRequiredParam'
responses:
'204':
- description: The Policy entry was successfully deleted.
+ description: The policy entry was successfully deleted.
'400':
description: |-
- The request could not be completed. The `policyId` does not conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
+ The request could not be completed. Possible reasons:
+
+ * the `policyId` does not conform to the namespaced entity ID notation (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id))
content:
application/json:
schema:
@@ -2817,14 +3453,18 @@
$ref: '#/components/schemas/AdvancedError'
'403':
description: |-
- The request could not be completed as the caller had insufficient permissions. For deleting a Policy entry of an existing Policy, `WRITE` permission on the resource `policy:/entries/{label}` is required is required without having any revoke.
+ The request could not be completed. Possible reasons:
+
+ * the caller has insufficient permissions.
+ You need `WRITE` permission on the `policy:/entries/{label}` resource,
+ without any revoke in a deeper path of the policy resource.
content:
application/json:
schema:
$ref: '#/components/schemas/AdvancedError'
'404':
description: |-
- The request could not be completed. The Policy with the given ID was
+ The request could not be completed. The policy with the given ID was
not found in the context of the authenticated user.
content:
application/json:
@@ -2834,18 +3474,19 @@
$ref: '#/components/responses/preconditionFailed'
'/policies/{policyId}/entries/{label}/subjects':
get:
- summary: Retrieve all Subjects of a Policy entry
+ summary: Retrieve all Subjects for a specific Label of a specific policy
description: |-
- Returns all Subjects of the Policy entry of the Policy identified by the
- `policyId` path parameter and for the label identified by the `label`
+ Returns all subject entries of the policy identified by the
+ `policyId` path parameter, and by the `label`
path parameter.
tags:
- Policies
parameters:
- $ref: '#/components/parameters/policyIdPathParam'
- $ref: '#/components/parameters/labelPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/timeoutParam'
responses:
'200':
description: The request successfully returned. The subjects are returned.
@@ -2864,8 +3505,9 @@
$ref: '#/components/responses/notModified'
'400':
description: |-
- The request could not be completed. The `policyId` does not conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
+ The request could not be completed. Possible reasons:
+
+ * the `policyId` does not conform to the namespaced entity ID notation (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id))
content:
application/json:
schema:
@@ -2879,8 +3521,8 @@
'404':
description: |-
- The request could not be completed. The Policy with the given ID or
- the Policy entry was not found in the context of the authenticated
+ The request could not be completed. The policy with the given ID or
+ the policy entry was not found in the context of the authenticated
user.
content:
application/json:
@@ -2889,18 +3531,33 @@
'412':
$ref: '#/components/responses/preconditionFailed'
put:
- summary: Create or modify all Subjects of a Policy Entry
+ summary: Create or modify all Subjects for a specific Label of a specific policy
description: |-
- Create or modify all Subjects of the Policy entry of the Policy
- identified by the `policyId` path parameter and with the label
- identified by the `label` path parameter.
+ Create or modify at once ALL subjects of the policy entry identified
+ by the `policyId` path parameter, and by the `label` path parameter.
+
+ ### Example - delete all subjects
+ To delete all subjects set an empty body { }
+
+ ### Example - entities authenticated by nginx
+ To add a user authenticated via pre-authentication at nginx:
+
+ ```
+ {
+ "nginx:ID-user": {
+ "type": "pre authenticated user from nginx"
+ }
+ }
+ ```
tags:
- Policies
parameters:
- $ref: '#/components/parameters/policyIdPathParam'
- $ref: '#/components/parameters/labelPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/timeoutParam'
+ - $ref: '#/components/parameters/responseRequiredParam'
responses:
'204':
description: The Subjects were successfully created or updated.
@@ -2913,9 +3570,10 @@
type: string
'400':
description: |-
- The request could not be completed. Either the `policyId` does not conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id))
- or the JSON was invalid, or no valid Subjects JSON object.
+ The request could not be completed. Possible reasons:
+
+ * the `policyId` does not conform to the namespaced entity ID notation (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id))
+ * the JSON body of the policy subjects to be created/modified is invalid
content:
application/json:
schema:
@@ -2929,14 +3587,19 @@
'403':
description: |-
- The request could not be completed as the caller had insufficient permissions. For modifying Subjects of an existing Policy entry, `WRITE` permission on the resource `policy:/entries/{label}/subjects` is required is required without having any revoke.
+ The request could not be completed. Possible reasons:
+
+ * the caller has insufficient permissions.
+ You need `WRITE` permission on the `policy:/entries/{label}/subjects` resource,
+ without any revoke in a deeper path of the policy resource.
+
content:
application/json:
schema:
$ref: '#/components/schemas/AdvancedError'
'404':
description: |-
- The request could not be completed. The Policy with the given ID was
+ The request could not be completed. The policy with the given ID was
not found in the context of the authenticated user.
content:
application/json:
@@ -2961,19 +3624,19 @@
required: true
'/policies/{policyId}/entries/{label}/subjects/{subjectId}':
get:
- summary: Retrieve one specific Subject of a Policy entry
+ summary: Retrieve one specific Subject for a specific Label of a specific policy
description: |-
- Returns the Subject with ID `subjectId` of the Policy entry identified
- by the `label` path parameter belonging to the Policy identified by the
- `policyId` path parameter.
+ Returns the subject with ID `subjectId` of the policy entry identified
+ by the `policyId` path parameter, and by the `label` path parameter.
tags:
- Policies
parameters:
- $ref: '#/components/parameters/policyIdPathParam'
- $ref: '#/components/parameters/labelPathParam'
- $ref: '#/components/parameters/subjectIdPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/timeoutParam'
responses:
'200':
description: |-
@@ -2994,8 +3657,9 @@
$ref: '#/components/responses/notModified'
'400':
description: |-
- The request could not be completed. The `policyId` does not conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
+ The request could not be completed. Possible reasons:
+
+ * the `policyId` does not conform to the namespaced entity ID notation (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id))
content:
application/json:
schema:
@@ -3009,8 +3673,8 @@
'404':
description: |-
- The request could not be completed. The Policy with the given ID,
- the Policy entry or the Subject was not found in the context of the
+ The request could not be completed. The policy with the given ID,
+ the policy entry or the Subject was not found in the context of the
authenticated user.
content:
application/json:
@@ -3019,19 +3683,21 @@
'412':
$ref: '#/components/responses/preconditionFailed'
put:
- summary: Create or modify one specific Subject of a Policy entry
+ summary: Create or modify one specific Subject for a specific Label of a specific policy
description: |-
- Create or modify the Subject with ID `subjectId` of the Policy entry
- identified by the `label` path parameter belonging to the Policy
- identified by the `policyId` path parameter.
+ Create or modify the subject with ID `subjectId` of the policy identified
+ by the `policyId` path parameter, and
+ by the `label` path parameter.
tags:
- Policies
parameters:
- $ref: '#/components/parameters/policyIdPathParam'
- $ref: '#/components/parameters/labelPathParam'
- $ref: '#/components/parameters/subjectIdPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/timeoutParam'
+ - $ref: '#/components/parameters/responseRequiredParam'
responses:
'201':
description: The Subject was successfully created.
@@ -3061,9 +3727,10 @@
type: string
'400':
description: |-
- The request could not be completed. Either the `policyId` does not conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id))
- or the JSON was invalid, or no valid Subject JSON object.
+ The request could not be completed. Possible reasons:
+
+ * the `policyId` does not conform to the namespaced entity ID notation (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)))
+ * the JSON body of the policy subject to be created/modified is invalid.
content:
application/json:
schema:
@@ -3077,15 +3744,19 @@
'403':
description: |-
- The request could not be completed as the caller had insufficient permissions. For modifying a Subject of an existing Policy entry, `WRITE` permission on the resource `policy:/entries/{label}/subjects/{subjectId}` is required without having any revoke.
+ The request could not be completed. Possible reasons:
+
+ * the caller has insufficient permissions.
+ You need `WRITE` permission on the root `policy:/entries/{label}/subjects/{subjectId}` resource,
+ without any revoke in a deeper path of the policy resource.
content:
application/json:
schema:
$ref: '#/components/schemas/AdvancedError'
'404':
description: |-
- The request could not be completed. The Policy with the given ID or
- the Policy entry was not found in the context of the authenticated
+ The request could not be completed. The policy with the given ID or
+ the policy entry was not found in the context of the authenticated
user.
content:
application/json:
@@ -3104,26 +3775,33 @@
description: JSON representation of the Subject
required: true
delete:
- summary: Delete one specific Subject of a Policy entry
+ summary: Delete one specific Subject for a specific Label of a specific policy
description: |-
- Deletes the Subject with ID `subjectId` of the Policy entry identified
- by the `label` path parameter belonging to the Policy identified by the
- `policyId` path parameter.
+ Deletes the subject with ID `subjectId` from the policy identified
+ by the `policyId` path parameter and
+ by the `label` path parameter.
+
+ Note: If the subject is used in other labels, it will not be deleted there,
+ i.e. it will not lose those permissions, but only the permissions defined in the
+ label specified at this path.
tags:
- Policies
parameters:
- $ref: '#/components/parameters/policyIdPathParam'
- $ref: '#/components/parameters/labelPathParam'
- $ref: '#/components/parameters/subjectIdPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/timeoutParam'
+ - $ref: '#/components/parameters/responseRequiredParam'
responses:
'204':
description: The Subject was successfully deleted.
'400':
description: |-
- The request could not be completed. The `policyId` does not conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
+ The request could not be completed. Possible reasons:
+
+ * the `policyId` does not conform to the namespaced entity ID notation (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id))
content:
application/json:
schema:
@@ -3136,15 +3814,19 @@
$ref: '#/components/schemas/AdvancedError'
'403':
description: |-
- The request could not be completed as the caller had insufficient permissions. For deleting a Subject of an existing Policy entry, `WRITE` permission on the resource `policy:/entries/{label}/subjects/{subjectId}` is required without having any revoke.
+ The request could not be completed. Possible reasons:
+
+ * the caller has insufficient permissions.
+ You need `WRITE` permission on the root `policy:/entries/{label}/subjects/{subjectId}` resource,
+ without any revoke in a deeper path of the policy resource.
content:
application/json:
schema:
$ref: '#/components/schemas/AdvancedError'
'404':
description: |-
- The request could not be completed. The Policy with the given ID,
- the Policy entry or the Subject was not found in the context of the
+ The request could not be completed. The policy with the given ID,
+ the policy entry or the Subject was not found in the context of the
authenticated user.
content:
application/json:
@@ -3154,18 +3836,19 @@
$ref: '#/components/responses/preconditionFailed'
'/policies/{policyId}/entries/{label}/resources':
get:
- summary: Retrieve all Resources of a Policy entry
+ summary: Retrieve all Resources for a specific Label of a specific policy
description: |-
- Returns all Resources of the Policy entry of the Policy identified by
- the `policyId` path parameter and for the label identified by the
- `label` path parameter.
+ Returns all resource entries of the policy identified by
+ the `policyId` path parameter,
+ and by the `label` path parameter.
tags:
- Policies
parameters:
- $ref: '#/components/parameters/policyIdPathParam'
- $ref: '#/components/parameters/labelPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/timeoutParam'
responses:
'200':
description: The request successfully returned. The resources are returned.
@@ -3184,8 +3867,9 @@
$ref: '#/components/responses/notModified'
'400':
description: |-
- The request could not be completed. The `policyId` does not conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
+ The request could not be completed. Possible reasons:
+
+ * the `policyId` does not conform to the namespaced entity ID notation (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id))
content:
application/json:
schema:
@@ -3199,8 +3883,8 @@
'404':
description: |-
- The request could not be completed. The Policy with the given ID or
- the Policy entry was not found in the context of the authenticated
+ The request could not be completed. The policy with the given ID or
+ the policy entry was not found in the context of the authenticated
user.
content:
application/json:
@@ -3209,18 +3893,65 @@
'412':
$ref: '#/components/responses/preconditionFailed'
put:
- summary: Create or modify all Resources of a Policy Entry
+ summary: Create or modify all Resources for a specific Label of a specific policy
description: |-
- Create or modify all Resources of the Policy entry of the Policy
- identified by the `policyId` path parameter and with the label
- identified by the `label` path parameter.
+ Create or modify all resources of the policy
+ identified by the `policyId` path parameter,
+ and by the `label` path parameter.
+
+ ### Delete all resource entries
+
+ Set the empty body part, if you need to delete all resource entries: { }
+
+ ### Set max permissions on all ressources
+ ```
+ {
+ "policy:/": {
+ "grant": [
+ "READ",
+ "WRITE"
+ ],
+ "revoke": []
+ },
+ "thing:/": {
+ "grant": [
+ "READ",
+ "WRITE"
+ ],
+ "revoke": []
+ },
+ "message:/": {
+ "grant": [
+ "READ",
+ "WRITE"
+ ],
+ "revoke": []
+ }
+ }
+ }
+ ```
+ ### Allow to read all parts of a thing except the "confidential" feature
+ ```
+ {
+ "thing:/": {
+ "grant": [ "READ" ],
+ "revoke": []
+ },
+ "things:/{thingId}/features/confidential:/": {
+ "grant": [],
+ "revoke": [ "READ"]
+ },
+ }
+ ```
tags:
- Policies
parameters:
- $ref: '#/components/parameters/policyIdPathParam'
- $ref: '#/components/parameters/labelPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/timeoutParam'
+ - $ref: '#/components/parameters/responseRequiredParam'
responses:
'204':
description: The Resources were successfully created or updated.
@@ -3233,9 +3964,10 @@
type: string
'400':
description: |-
- The request could not be completed. Either the `policyId` does not conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id))
- or the JSON was invalid, or no valid Resources JSON object.
+ The request could not be completed. Possible reasons:
+
+ * the `policyId` does not conform to the namespaced entity ID notation (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id))
+ * the JSON is invalid, or no valid Resources JSON object.
content:
application/json:
schema:
@@ -3249,15 +3981,19 @@
'403':
description: |-
- The request could not be completed as the caller had insufficient permissions. For modifying Resources of an existing Policy entry, `WRITE` permission on the resource `policy:/entries/{label}/resources` is required without having any revoke.
+ The request could not be completed. Possible reasons:
+
+ * the caller has insufficient permissions.
+ You need `WRITE` permission on the root `policy:/entries/{label}/resources` resource,
+ without any revoke in a deeper path of the policy resource.
content:
application/json:
schema:
$ref: '#/components/schemas/AdvancedError'
'404':
description: |-
- The request could not be completed. The Policy with the given ID or
- the Policy entry was not found in the context of the authenticated
+ The request could not be completed. The policy with the given ID or
+ the policy entry was not found in the context of the authenticated
user.
content:
application/json:
@@ -3277,19 +4013,20 @@
required: true
'/policies/{policyId}/entries/{label}/resources/{resourcePath}':
get:
- summary: Retrieve one specific Resource of a Policy entry
+ summary: Retrieve one specific Resource for a specific Label of a specific policy
description: |-
- Returns the Resource with path `resourcePath` of the Policy entry
- identified by the `label` path parameter belonging to the Policy
- identified by the `policyId` path parameter.
+ Returns the resource with path `resourcePath` of the policy identified
+ by the `policyId` path parameter, and
+ by the `label` path parameter.
tags:
- Policies
parameters:
- $ref: '#/components/parameters/policyIdPathParam'
- $ref: '#/components/parameters/labelPathParam'
- $ref: '#/components/parameters/resourcePathPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/timeoutParam'
responses:
'200':
description: |-
@@ -3310,8 +4047,9 @@
$ref: '#/components/responses/notModified'
'400':
description: |-
- The request could not be completed. The `policyId` does not conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
+ The request could not be completed. Possible reasons:
+
+ * the `policyId` does not conform to the namespaced entity ID notation (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id))
content:
application/json:
schema:
@@ -3325,8 +4063,8 @@
'404':
description: |-
- The request could not be completed. The Policy with the given ID,
- the Policy entry or the Resource was not found in the context of the
+ The request could not be completed. The policy with the given ID,
+ the policy entry or the Resource was not found in the context of the
authenticated user.
content:
application/json:
@@ -3335,10 +4073,10 @@
'412':
$ref: '#/components/responses/preconditionFailed'
put:
- summary: Create or modify one specific Resource of a Policy entry
+ summary: Create or modify one specific Resource for a specific Label of a specific policy
description: |-
- Create or modify the Resource with path `resourcePath` of the Policy
- entry identified by the `label` path parameter belonging to the Policy
+ Create or modify the Resource with path `resourcePath` of the policy
+ entry identified by the `label` path parameter belonging to the policy
identified by the `policyId` path parameter.
tags:
- Policies
@@ -3346,8 +4084,10 @@
- $ref: '#/components/parameters/policyIdPathParam'
- $ref: '#/components/parameters/labelPathParam'
- $ref: '#/components/parameters/resourcePathPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/timeoutParam'
+ - $ref: '#/components/parameters/responseRequiredParam'
responses:
'201':
description: The Resource was successfully created.
@@ -3379,9 +4119,10 @@
$ref: '#/components/responses/notModified'
'400':
description: |-
- The request could not be completed. Either the `policyId` does not conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id))
- or the JSON was invalid, or no valid Resource JSON object.
+ The request could not be completed. Possible reasons:
+
+ * the `policyId` does not conform to the namespaced entity ID notation (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id))
+ * the JSON is invalid, or no valid Resource JSON object.
content:
application/json:
schema:
@@ -3395,15 +4136,19 @@
'403':
description: |-
- The request could not be completed as the caller had insufficient permissions. For modifying a Resource of an existing Policy entry, `WRITE` permission on the resource `policy:/entries/{label}/resources/{resourcePath}` is required without having any revoke.
+ The request could not be completed. Possible reasons:
+
+ * the caller has insufficient permissions.
+ You need `WRITE` permission on the `policy:/entries/{label}/resources/{resourcePath}` resource,
+ without any revoke in a deeper path of the policy resource.
content:
application/json:
schema:
$ref: '#/components/schemas/AdvancedError'
'404':
description: |-
- The request could not be completed. The Policy with the given ID or
- the Policy entry was not found in the context of the authenticated
+ The request could not be completed. The policy with the given ID or
+ the policy entry was not found in the context of the authenticated
user.
content:
application/json:
@@ -3422,26 +4167,29 @@
description: JSON representation of the Resource
required: true
delete:
- summary: Delete one Resource of a Policy entry
+ summary: Delete one specific Resource for a specific Label of a specific policy
description: |-
- Deletes the Resource with path `resourcePath` of the Policy entry
- identified by the `label` path parameter belonging to the Policy
- identified by the `policyId` path parameter.
+ Deletes the resource with path `resourcePath` from the policy
+ identified by the the `policyId` path parameter, and by the
+ `label` path parameter.
tags:
- Policies
parameters:
- $ref: '#/components/parameters/policyIdPathParam'
- $ref: '#/components/parameters/labelPathParam'
- $ref: '#/components/parameters/resourcePathPathParam'
- - $ref: '#/components/parameters/ifMatchHeaderParam'
+ - $ref: '#/components/parameters/ifMatchHeaderParamHash'
- $ref: '#/components/parameters/ifNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/timeoutParam'
+ - $ref: '#/components/parameters/responseRequiredParam'
responses:
'204':
description: The Resource was successfully deleted.
'400':
description: |-
- The request could not be completed. The `policyId` does not conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
+ The request could not be completed. Possible reasons:
+
+ * the `policyId` does not conform to the namespaced entity ID notation (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id))
content:
application/json:
schema:
@@ -3454,15 +4202,19 @@
$ref: '#/components/schemas/AdvancedError'
'403':
description: |-
- The request could not be completed as the caller had insufficient permissions. For deleting a Resource of an existing Policy entry, `WRITE` permission on the resource `policy:/entries/{label}/resources/{resourcePath}` is required without having any revoke.
+ The request could not be completed. Possible reasons:
+
+ * the caller has insufficient permissions.
+ You need `WRITE` permission on the `policy:/entries/{label}/resources/{resourcePath}` resource,
+ without any revoke in a deeper path of the policy resource.
content:
application/json:
schema:
$ref: '#/components/schemas/AdvancedError'
'404':
description: |-
- The request could not be completed. The Policy with the given ID,
- the Policy entry or the Resource was not found in the context of the
+ The request could not be completed. The policy with the given ID,
+ the policy entry or the Resource was not found in the context of the
authenticated user.
content:
application/json:
@@ -3475,47 +4227,50 @@
###
/search/things:
get:
- summary: Search for Things
+ summary: Search for things
description: |-
This resource can be used to search for things.
- The query parameter `filter` is not mandatory. If it is not set there
- are returned all things which the logged in user is allowed to read. The
- resource supports sorting and paging. If paging is not explicitly
- specified by means of the `limit` option, a default count of `25`
- documents is returned.
+ * The query parameter `filter` is not mandatory. If it is not set, the
+ result contains all things which the logged in user is allowed to read.
- To search for nested properties, we use JSON Pointer notation
- (RFC-6901). See the following example how to search for the sub property
- `location` of the parent property `attributes` with a forward slash as
- separator:
+ * The search is case sensitive. In case you don't know how exactly the
+ spelling of the namespace, name, attribute, feature etc. is, use the *like*
+ notation for filtering
- ```eq(attributes/location,"kitchen")```
+ * The resource supports sorting and paging. If paging is not explicitly
+ specified by means of the `size` option, a default count of `25`
+ documents is returned.
+
+ * The internal search index is "eventually consistent". Consistency with the latest
+ thing updates should recover within milliseconds.
+
parameters:
- $ref: '#/components/parameters/searchFilter'
- $ref: '#/components/parameters/namespacesFilter'
- $ref: '#/components/parameters/thingFieldsQueryParam'
+ - $ref: '#/components/parameters/timeoutParam'
- name: option
in: query
description: |-
Possible values for the parameter:
- ###### Sort operations
+ #### Sort operations
* ```sort([+|-]{property})```
* ```sort([+|-]{property},[+|-]{property},...)```
- ###### Paging operations
+ #### Paging operations
- * ```size({page-size})``` Maximum allowed page-size is `200`.
+ * ```size({page-size})``` Maximum allowed page size is `200`. Default page size is `25`.
* ```cursor({cursor-id})``` Start the search from the cursor location. Specify the cursor ID without
- quotation marks. Cursor IDs are given in responses and mark the position after the final search result.
- The meaning of cursor IDs is unspecified and may change without notice.
+ quotation marks. Cursor IDs are given in search responses and mark the position after the last entry of
+ the previous search. The meaning of cursor IDs is unspecified and may change without notice.
The paging option `limit({offset},{count})` is deprecated.
- It may result in slow queries, time-outs and will be removed eventually.
+ It may result in slow queries or timeouts and will be removed eventually.
- ##### Examples:
+ #### Examples:
* ```sort(+thingId)```
* ```sort(-attributes/manufacturer)```
@@ -3523,7 +4278,7 @@
* ```size(10)``` return 10 results
* ```cursor(LOREMIPSUM)``` return results after the position of the cursor `LOREMIPSUM`.
- ##### Combine:
+ #### Combine:
If you need to specify multiple options, when using the swagger UI just write each option in a new line.
When using the plain REST API programmatically,
@@ -3531,12 +4286,11 @@
```size(200),cursor(LOREMIPSUM)```
- The deprecated paging option `limit` may not combine with the other paging options `size` and `cursor`.
+ The deprecated paging option `limit` may not be combined with the other paging options `size` and `cursor`.
required: false
schema:
- type: array
- items:
- type: string
+ type: string
+
tags:
- Things-Search
responses:
@@ -3548,7 +4302,7 @@
$ref: '#/components/schemas/SearchResultThings'
'400':
description: |-
- The request could not be completed. A provided parameter was in a
+ The request could not be completed. A provided parameter is in a
wrong format.
content:
application/json:
@@ -3574,7 +4328,7 @@
$ref: '#/components/schemas/AdvancedError'
/search/things/count:
get:
- summary: Count Things
+ summary: Count things
description: |-
This resource can be used to count things.
@@ -3591,6 +4345,7 @@
parameters:
- $ref: '#/components/parameters/searchFilter'
- $ref: '#/components/parameters/namespacesFilter'
+ - $ref: '#/components/parameters/timeoutParam'
tags:
- Things-Search
responses:
@@ -3602,7 +4357,7 @@
$ref: '#/components/schemas/SearchResultThingsCount'
'400':
description: |-
- The request could not be completed. A provided parameter was in a
+ The request could not be completed. A provided parameter is in a
wrong format.
content:
application/json:
@@ -3668,20 +4423,21 @@
- message
Attributes:
type: object
- description: "Attributes of a Thing: an arbitrary JSON object."
+ description: An arbitrary JSON object describing the attributes of a thing.
Definition:
type: string
description: "A single fully qualified identifier of a definition in the form 'namespace:name:version'"
pattern: ([_a-zA-Z0-9\-.]+):([_a-zA-Z0-9\-.]+):([_a-zA-Z0-9\-.]+)
FeatureDefinition:
type: array
+ description: The definitions of a feature.
items:
type: string
- description: "A single fully qualified identifier of a Feature definition in the form 'namespace:name:version'"
+ description: "A single fully qualified identifier of a feature definition in the form 'namespace:name:version'"
pattern: ([_a-zA-Z0-9\-.]+):([_a-zA-Z0-9\-.]+):([_a-zA-Z0-9\-.]+)
FeatureProperties:
type: object
- description: "Properties of a Feature: an arbitrary JSON object."
+ description: An arbitrary JSON object describing the properties of a feature.
Feature:
type: object
properties:
@@ -3703,23 +4459,29 @@
type: object
properties:
_policy:
- $ref: '#/components/schemas/InitialPolicy'
+ allOf:
+ - $ref: '#/components/schemas/Policy'
+ description: |-
+ The initial policy to create for this thing. This will create a separate policy entity managed by resource `/policies/{thingId}`.
+
+
+ Use the placeholder `{{ request:subjectId }}` in order to let the backend insert the authenticated subjectId of the HTTP request.
_copyPolicyFrom:
type: string
description: |-
- This field may contain the Policy ID of an existing Policy.
- The Policy is copied and used for this newly created Thing. This field may also contain a placeholder
- reference to a Thing in the format `{{ ref:things/[thingId]/policyId }}` where you need to replace `[thingId]`
- with a valid Thing ID. The newly created Thing will then obtain a copy of the Policy of the referenced Thing.
- In the case of using a reference, the caller needs to have READ access to both the Thing and the Policy of the Thing.
- In the case of using an explicit policy id to copy from, the caller needs to have READ access to the Policy.
- If you want to specify a Policy ID for the copied policy, use the policyId field.
+ This field may contain the policy ID of an existing policy.
+ The policy is copied and used for this newly created thing. This field may also contain a placeholder
+ reference to a thing in the format `{{ ref:things/[thingId]/policyId }}` where you need to replace `[thingId]`
+ with a valid thing ID. The newly created thing will then obtain a copy of the policy of the referenced thing.
+ In the case of using a reference, the caller needs to have READ access to both the thing and the policy of the thing.
+ In the case of using an explicit policy id to copy from, the caller needs to have READ access to the policy.
+ If you want to specify a policy ID for the copied policy, use the policyId field.
This field must not be used together with the field `_policy`. If you specify both `_policy` and
`_copyPolicyFrom` this will lead to an error response.
policyId:
type: string
description: |-
- The Policy ID used for controlling access to this Thing. Managed by
+ The policy ID used for controlling access to this thing. Managed by
resource `/policies/{policyId}`.
definition:
$ref: '#/components/schemas/Definition'
@@ -3738,13 +4500,10 @@
properties:
thingId:
type: string
- description: Unique identifier representing the Thing, has to conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
+ description: Unique identifier representing the thing
policyId:
type: string
- description: The policy ID used for controlling access to this thing, managed by resource `/policies/{policyId}`,
- has to conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
+ description: The ID of the policy which controls the access to this thing. policies are managed by resource `/policies/{policyId}`
definition:
$ref: '#/components/schemas/Definition'
attributes:
@@ -3753,21 +4512,13 @@
$ref: '#/components/schemas/Features'
Policy:
type: object
- description: Policy consisting of PolicyEntries
- properties:
- entries:
- $ref: '#/components/schemas/PolicyEntries'
- InitialPolicy:
- type: object
- description: |-
- The initial Policy when creating a Thing. This will create a separate Policy entity managed by resource `/policies/{thingId}`.
- Use the placeholder `{{ request:subjectId }}` in order to let the backend insert the authenticated subjectId of the HTTP request.
+ description: policy consisting of policy entries
properties:
entries:
$ref: '#/components/schemas/PolicyEntries'
PolicyEntries:
type: object
- description: PolicyEntries containing one PolicyEntry for each arbitrary `label` key
+ description: Policy entries containing one policy entry for each arbitrary `label` key
properties:
label1:
$ref: '#/components/schemas/PolicyEntry'
@@ -3775,7 +4526,7 @@
$ref: '#/components/schemas/PolicyEntry'
PolicyEntry:
type: object
- description: Single Policy entry containing Subjects and Resources.
+ description: Single policy entry containing Subjects and Resources.
required:
- subjects
- resources
@@ -3787,13 +4538,11 @@
Subjects:
type: object
description: |-
- (Authorization) Subjects containing one SubjectEntry for each arbitrary
- `issuer:subjectId` key. `issuer` being one of the following
- `iot-permissions`, `iot-things`
+ A SubjectEntry defines who is addressed.
properties:
- 'iot-permissions:subjectId1':
+ 'nginx:subjectId1':
$ref: '#/components/schemas/SubjectEntry'
- 'iot-permissions:subjectIdN':
+ 'nginx:subjectIdN':
$ref: '#/components/schemas/SubjectEntry'
SubjectEntry:
type: object
@@ -3803,20 +4552,12 @@
properties:
type:
type: string
- description: the type of the (Authorization) Subject
- enum:
- - iot-permissions-sid
- - iot-permissions-userid
- - iot-permissions-groupid
- - iot-permissions-roleid
- - iot-things-clientid
- - jwt
+ description: The type is offered only for documentation purposes. You are not restricted to any specific types, but we recommend to use it to specify the kind of the subject as shown in our examples.
Resources:
type: object
description: |-
(Authorization) Resources containing one ResourceEntry for each
- `type:path` key, `type` being one of the following `thing`, `policy`,
- `message`
+ `type:path` key, `type` being one of the following `thing`, `policy`, `message`.
properties:
'thing:/':
$ref: '#/components/schemas/ResourceEntry'
@@ -3863,7 +4604,7 @@
Features:
type: object
description: |-
- List of Features where the key represents the `featureId` of each Feature.
+ List of features where the key represents the `featureId` of each feature.
The `featureId` key must be unique in the list.
additionalProperties:
$ref: '#/components/schemas/Feature'
@@ -3896,8 +4637,8 @@
type: string
preconditionFailed:
description: |-
- A precondition for reading or writing the (sub-)resource failed. This will happen for write requests, when you
- specified an If-Match or If-None-Match header which fails the precondition check against the current ETag of
+ A precondition for reading or writing the (sub-)resource failed. This will happen for write requests, if you
+ specified an If-Match or If-None-Match header, which fails the precondition check against the current ETag of
the (sub-)resource. For read requests, this error may only happen for a failing If-Match header. In case of a
failing If-None-Match header for a read request, status 304 will be returned instead.
headers:
@@ -3913,11 +4654,21 @@
$ref: '#/components/schemas/AdvancedError'
parameters:
- ifMatchHeaderParam:
+ ifMatchHeaderParamHash:
name: If-Match
in: header
description: >-
The `If-Match` header which has to conform to RFC-7232 (Conditional Requests). Common usages are:
+ * optimistic locking by specifying the `ETag` from a previous HTTP response, e.g. `If-Match: "hash:a75ece4e"`
+ * retrieving or modifying a resource only if it already exists, e.g. `If-Match: *`
+ required: false
+ schema:
+ type: string
+ ifMatchHeaderParam:
+ name: If-Match
+ in: header
+ description: >-
+ The `If-Match` header, which has to conform to RFC-7232 (Conditional Requests). Common usages are:
* optimistic locking by specifying the `ETag` from a previous GET response, e.g. `If-Match: "rev:4711"`
* retrieving or modifying a resource only if it already exists, e.g. `If-Match: *`
required: false
@@ -3927,7 +4678,7 @@
name: If-None-Match
in: header
description: >-
- The `If-None-Match` header which has to conform to RFC-7232 (Conditional Requests). A common usage scenario is to
+ The `If-None-Match` header, which has to conform to RFC-7232 (Conditional Requests). A common usage scenario is to
modify a resource only if it does not yet exist, thus to create it, by specifying `If-None-Match: *`.
required: false
schema:
@@ -3935,14 +4686,14 @@
featureIdPathPathParam:
name: featureId
in: path
- description: The ID of the Feature - has to conform to RFC-3986 (URI)
+ description: The ID of the feature - has to conform to RFC-3986 (URI)
required: true
schema:
type: string
attributePathPathParam:
name: attributePath
in: path
- description: The path to the Attribute
+ description: The path to the attribute, e.g. **manufacturer/name**
required: true
schema:
type: string
@@ -3950,8 +4701,7 @@
name: thingId
in: path
description: |-
- The ID of the Thing has to conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
+ The ID of a thing needs to follow the namespaced entity ID notation (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
required: true
schema:
type: string
@@ -3959,8 +4709,10 @@
name: policyId
in: path
description: |-
- The ID of the Policy has to conform to the namespaced entity ID notation
- (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
+ The ID of the policy needs to follow the namespaced entity ID notation (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).
+
+ The namespace needs to:
+ * conform to the reverse domain name notation
required: true
schema:
type: string
@@ -3991,12 +4743,50 @@
required: false
schema:
type: integer
+ requestedAcksParam:
+ name: requested-acks
+ in: query
+ description: |-
+ Contains the "requested acknowledgements" for this modifying request as comma separated list. The HTTP call will
+ block until all requested acknowledgements were aggregated or will time out based on the specified `timeout`
+ parameter.
+
+ The default (if omitted) requested acks is `requested-acks=twin-persisted` which will block the
+ HTTP call until the change was persited to the twin.
+ required: false
+ schema:
+ type: string
+ timeoutParam:
+ name: timeout
+ in: query
+ description: |-
+ Defines how long the backend should wait for completion of the request, e.g. applied when waiting for requested
+ acknowledgements via the `requested-acks` param. Can be specified without unit (then seconds are assumed) or
+ together with `s`, `ms` or `m` unit. Example: `42s`, `1m`.
+
+ The default (if omitted) timeout is `10s`. Maximum value: `60s`.
+
+ A value of `0` applies fire and forget semantics for the command resulting in setting `response-required=false`.
+ required: false
+ schema:
+ type: string
+ responseRequiredParam:
+ name: response-required
+ in: query
+ description: |-
+ Defines whether a response is required to the API call or not - if set to `false` the response will directly
+ sent back with a status code of `202` (Accepted).
+
+ The default (if ommited) response is `true`.
+ required: false
+ schema:
+ type: boolean
labelPathParam:
name: label
in: path
- description: The label of a Policy entry
+ description: The label of a policy entry
required: true
schema:
type: string
@@ -4017,7 +4807,7 @@
propertyPathPathParam:
name: propertyPath
in: path
- description: The path to the Property
+ description: The path to the property
required: true
schema:
type: string
@@ -4025,42 +4815,42 @@
name: fields
in: query
description: |-
- Contains a comma separated list of fields to be included in the returned
- JSON. Attributes can be selected in the same manner.
+ Contains a comma-separated list of fields to be included in the returned
+ JSON. attributes can be selected in the same manner.
#### Selectable fields
* `thingId`
-
* `policyId`
-
- * `_policy`
-
- Specifically selects the policy of the Thing. (The policy is not contained in the returned JSON per default.)
-
+ * `definition`
* `attributes`
- Supports selecting arbitrary sub-fields by using a comma separated list:
- * several attribute paths can be passed as a comma separated list of JSON pointers (RFC-6901)
+ Supports selecting arbitrary sub-fields by using a comma-separated list:
+ * several attribute paths can be passed as a comma-separated list of JSON pointers (RFC-6901)
For example:
* `?fields=attributes/model` would select only `model` attribute value (if present)
- * `?fields=attributes/model,attributes/make` would select only `model` and `make` attribute values (if present)
+ * `?fields=attributes/model,attributes/location` would select only `model` and
+ `location` attribute values (if present)
Supports selecting arbitrary sub-fields of objects by wrapping sub-fields inside parentheses `( )`:
- * a comma-separated list of sub-fields (a sub-field is a JSON pointer (RFC-6901) separated with `/`) to select
- * sub-selectors can be used to request only specific sub-fields by placing expressions in parentheses `( )` after a selected subfield
+ * a comma-separated list of sub-fields (a sub-field is a JSON pointer (RFC-6901)
+ separated with `/`) to select
+
+ * sub-selectors can be used to request only specific sub-fields by placing expressions
+ in parentheses `( )` after a selected subfield
For example:
- * `?fields=attributes(model,make)` would select only `model` and `make` attribute values (if present)
- * `?fields=attributes(location/longitude)` would select the `longitude` value inside the `location` object
- * `?fields=attributes/address/postal(city,street)` would select the `city` and `street` values inside the `postal` object inside the `address` object
-
- * `definition`
+ * `?fields=attributes(model,location)` would select only `model`
+ and `location` attribute values (if present)
+ * `?fields=attributes(coffeemaker/serialno)` would select the `serialno` value
+ inside the `coffeemaker` object
+ * `?fields=attributes/address/postal(city,street)` would select the `city` and
+ `street` values inside the `postal` object inside the `address` object
* `features`
- Supports selecting arbitrary fields in features similar to `attributes` (see also Features documentation for more details)
+ Supports selecting arbitrary fields in features similar to `attributes` (see also features documentation for more details)
* `_namespace`
@@ -4068,20 +4858,21 @@
* `_revision`
- Specifically selects the revision of the Thing. The revision is a counter which is incremented on each modification of a Thing.
+ Specifically selects the revision of the thing. The revision is a counter, which is incremented on each modification of a thing.
* `_modified`
- Specifically selects the modified timestamp of the Thing in ISO-8601 UTC format. The timestamp is set on each modification of a Thing.
+ Specifically selects the modified timestamp of the thing in ISO-8601 UTC format. The timestamp is set on each modification of a thing.
+
+ * `_policy`
+
+ Specifically selects the content of the policy associated to the thing. (By default, only the policyId is returned.)
#### Examples
* `?fields=thingId,attributes,features`
+ * `?fields=attributes(model,manufacturer),features`
- * `?fields=attributes(model,make),features`
-
- *
- `?fields=thingId,attributes/location/longitude,attributes/address(city,street)`
required: false
schema:
type: string
@@ -4089,18 +4880,18 @@
name: fields
in: query
description: |-
- Contains a comma separated list of fields from the attributes to be
+ Contains a comma-separated list of fields from the attributes to be
included in the returned JSON.
#### Selectable fields
Supports selecting arbitrary sub-fields as defined in the attributes by
- using a comma separated list:
- * several properties paths can be passed as a comma separated list of JSON pointers (RFC-6901)
+ using a comma-separated list:
+ * several properties paths can be passed as a comma-separated list of JSON pointers (RFC-6901)
For example:
* `?fields=model` would select only `model` attribute value (if present)
- * `?fields=model,make` would select only `model` and `make` attribute values (if present)
+ * `?fields=model,make` would select `model` and `make` attribute values (if present)
Supports selecting arbitrary sub-fields of objects by wrapping sub-fields
inside parentheses `( )`:
@@ -4122,14 +4913,14 @@
name: fields
in: query
description: |-
- Contains a comma separated list of fields from the properties to be
+ Contains a comma-separated list of fields from the properties to be
included in the returned JSON.
#### Selectable fields
Supports selecting arbitrary sub-fields as defined in the properties by
- using a comma separated list:
- * several properties paths can be passed as a comma separated list of JSON pointers (RFC-6901)
+ using a comma-separated list:
+ * several properties paths can be passed as a comma-separated list of JSON pointers (RFC-6901)
For example:
* `?fields=temperature` would select only `temperature` property value (if present)
@@ -4155,37 +4946,29 @@
name: fields
in: query
description: |-
- Contains a comma separated list of fields from one or more Features to be
+ Contains a comma-separated list of fields from one or more features to be
included in the returned JSON.
#### Selectable fields
- * `{featureId}` The ID of the Feature to select properties in
-
+ * `{featureId}` The ID of the feature to select properties in
* `properties`
-
- Supports selecting arbitrary sub-fields by using a comma separated list:
- * several properties paths can be passed as a comma separated list of JSON pointers (RFC-6901)
-
+ Supports selecting arbitrary sub-fields by using a comma-separated list:
+ * several properties paths can be passed as a comma-separated list of JSON pointers (RFC-6901)
For example:
- * `?fields={featureId}/properties/color` would select only `color` property value (if present) of the Feature identified with `{featureId}`
- * `?fields={featureId}/properties/color,properties/brightness` would select only `color` and `brightness` property values (if present) of the Feature identified with `{featureId}`
-
+ * `?fields={featureId}/properties/color` would select only `color` property value (if present) of the feature identified with `{featureId}`
+ * `?fields={featureId}/properties/color,properties/brightness` would select only `color` and `brightness` property values (if present) of the feature identified with `{featureId}`
Supports selecting arbitrary sub-fields of objects by wrapping sub-fields inside parentheses `( )`:
* a comma-separated list of sub-fields (a sub-field is a JSON pointer (RFC-6901) separated with `/`) to select
* sub-selectors can be used to request only specific sub-fields by placing expressions in parentheses `( )` after a selected subfield
-
For example:
- * `?fields={featureId}/properties(color,brightness)` would select only `color` and `brightness` property values (if present) of the Feature identified with `{featureId}`
- * `?fields={featureId}/properties(location/longitude)` would select the `longitude` value inside the `location` object of the Feature identified with `{featureId}`
+ * `?fields={featureId}/properties(color,brightness)` would select only `color` and `brightness` property values (if present) of the feature identified with `{featureId}`
+ * `?fields={featureId}/properties(location/longitude)` would select the `longitude` value inside the `location` object of the feature identified with `{featureId}`
#### Examples
-
* `?fields=EnvironmentScanner/properties(temperature,humidity)`
-
- *
- `?fields=EnvironmentScanner/properties(temperature,humidity),Vehicle/properties/configuration`
+ * `?fields=EnvironmentScanner/properties(temperature,humidity),Vehicle/properties/configuration`
required: false
schema:
type: string
@@ -4193,15 +4976,15 @@
name: fields
in: query
description: |-
- Contains a comma separated list of fields from the selected Feature to be
+ Contains a comma-separated list of fields from the selected feature to be
included in the returned JSON.
#### Selectable fields
* `properties`
- Supports selecting arbitrary sub-fields by using a comma separated list:
- * several properties paths can be passed as a comma separated list of JSON pointers (RFC-6901)
+ Supports selecting arbitrary sub-fields by using a comma-separated list:
+ * several properties paths can be passed as a comma-separated list of JSON pointers (RFC-6901)
For example:
* `?fields=properties/color` would select only `color` property value (if present)
@@ -4226,25 +5009,25 @@
in: query
description: |-
- ##### Filter operations:
+ #### Filter predicates:
- * ```eq({property},{value})```
+ * ```eq({property},{value})``` (i.e. equal to the given value)
- * ```ne({property},{value})```
+ * ```ne({property},{value})``` (i.e. not equal to the given value)
- * ```gt({property},{value})```
+ * ```gt({property},{value})``` (i.e. greater than the given value)
- * ```ge({property},{value})```
+ * ```ge({property},{value})``` (i.e. equal to the given value or greater than it)
- * ```lt({property},{value})```
+ * ```lt({property},{value})``` (i.e. lower than the given value or equal to it)
- * ```le({property},{value})```
+ * ```le({property},{value})``` (i.e. lower than the given value)
- * ```in({property},{value},{value},...)```
+ * ```in({property},{value},{value},...)``` (i.e. contains at least one of the values listed)
- * ```like({property},{value})```
+ * ```like({property},{value})``` (i.e. contains values similar to the expressions listed)
- * ```exists({property})```
+ * ```exists({property})``` (i.e. all things in which the given path exists)
Note: When using filter operations, only things with the specified properties are returned.
@@ -4252,7 +5035,7 @@
the `owner` attribute.
- ##### Logical operations:
+ #### Logical operations:
* ```and({query},{query},...)```
@@ -4262,15 +5045,27 @@
* ```not({query})```
- ##### Examples:
+ #### Examples:
* ```eq(attributes/location,"kitchen")```
+ * ```ge(thingId,"myThing1")```
+
* ```exists(features/featureId)```
* ```and(eq(attributes/location,"kitchen"),eq(attributes/color,"red"))```
* ```or(eq(attributes/location,"kitchen"),eq(attributes/location,"living-room"))```
+
+ * ```like(attributes/key1,"known-chars-at-start*")```
+
+ * ```like(attributes/key1,"*known-chars-at-end")```
+
+ * ```like(attributes/key1,"*known-chars-in-between*")```
+
+ * ```like(attributes/key1,"just-som?-char?-unkn?wn")```
+
+ The `like` filters with the wildcard `*` at the beginning can slow down your search request.
required: false
schema:
type: string
@@ -4278,8 +5073,8 @@
name: namespaces
in: query
description: |-
- A comma separated list of namespaces. This list is used to limit the query to things in the given namespaces
- only. When this parameter is omitted, all namespaces will be queried.
+ A comma-separated list of namespaces. This list is used to limit the query to things in the given namespaces
+ only.
#### Examples:
@@ -4309,6 +5104,7 @@
description: |-
Payload of the message with max size of 250 kB. It can be any HTTP
supported content, including binary content.
+
Definition:
content:
application/json:
@@ -4319,19 +5115,33 @@
JSON string of the definition to be modified. Consider that the
value has to be a JSON string or `null`, examples:
- * an string: `{ ""value"}` -}. Currently the definition must follow the pattern: [_a-zA-Z0-9\-]:[_a-zA-Z0-9\-]:[_a-zA-Z0-9\-]
+ * an string: `{ ""value"}` -}. Currently the definition should follow the pattern: [_a-zA-Z0-9\-]:[_a-zA-Z0-9\-]:[_a-zA-Z0-9\-]
+ * an empty string: `""`
+
Attributes:
content:
application/json:
schema:
$ref: '#/components/schemas/Attributes'
- example: {}
+ example: {
+ "manufacturer": {
+ "name": "ACME demo corp.",
+ "location": "Berlin, main floor"
+ },
+ "coffeemaker": {
+ "serialno": "42",
+ "model": "Speaking coffee machine"
+ }
+ }
description: |-
- JSON object of all Attributes to be modified at once. Consider that the
- value has to be a JSON object or `null`, examples:
+ JSON object of all attributes to be modified at once. Consider that the
+ value has to be a JSON object or `null`.
- * an object: `{ "key": "value"}` -} We strongly recommend to use a restricted set of characters for the key (identifier). Currently these identifiers should follow the pattern: [_a-zA-Z][_a-zA-Z0-9\-]*
- * an empty object: `{}`
+ Examples:
+ * an empty object: `{}` - would just delete all old attributes
+ * a simple object: `{ "key": "value"}` - We strongly recommend to use a restricted set of characters for the key (identifier), as the key might be needed for the (URL) path later.<br> Currently these identifiers should follow the pattern: [_a-zA-Z][_a-zA-Z0-9\-]*
+ * a nested object as shown in the example value
+
required: true
Value:
content:
@@ -4349,7 +5159,7 @@
* for a string, the JSON value must be quoted: `"aString"`
- * for a boolean, the JSON vallue is the boolean: `true`
+ * for a boolean, the JSON value is the boolean: `true`
* for an object, the JSON value is the object: `{ "key": "value"}` -} We strongly recommend to use a restricted set of characters for the key (identifier). Currently these identifiers should follow the pattern: [_a-zA-Z][_a-zA-Z0-9\-]*
diff --git a/1.0/presentations.html b/1.0/presentations.html
index e7d2516..5676a8f 100644
--- a/1.0/presentations.html
+++ b/1.0/presentations.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1248,17 +1469,30 @@
- <p>This page contains a collection of presentation about Eclipse Ditto.</p>
+ <p>This page contains a collection of presentations, videos and workshops about Eclipse Ditto, sorted from most recent ones downwards.</p>
-<h2 id="07022018-virtual-iot-meetup">07.02.2018 Virtual IoT Meetup</h2>
+<h2 id="16042020-the-things-network-virtual-conference-2020-stayhome">16.04.2020 The Things Network Virtual Conference 2020 #StayHome</h2>
-<p>Topic: “Digital twins go open source: Eclipse Ditto introduction”</p>
+<p>Topic: Eclipse Ditto: Digital Twins as part of an open IoT platform</p>
-<p>On 07.02.2018 we gave an introduction into Eclipse Ditto via <a href="https://www.meetup.com/Virtual-IoT/events/247048104/">Meetup</a>.</p>
+<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/D33JrN2RWiI" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen=""></iframe>
-<p>The slides can be found here: <a href="slides/2018_02_07-virtualiot-meetup/index.html">2018_02_07-virtualiot-meetup</a>.</p>
+<p>The slides can be found here: <a href="slides/2020_04_16-ttn-virtual-conference/index.html">2020_04_16-ttn-virtual-conference</a>.</p>
-<p>The video was streamed to <a href="https://youtu.be/NpC4ROGqwKc">YouTube</a> and the recording will stay available there.</p>
+<p>The blogpost for the hands-on part, connecting Ditto to The Things Network via MQTT can be found
+<a href="2020-04-16-connecting-to-ttn-via-mqtt.html">here</a>.</p>
+
+<h2 id="21102019-eclipsecon-europe-2019-in-ludwigsburg">21.10.2019 EclipseCon Europe 2019 in Ludwigsburg</h2>
+
+<p>Topic: Project status update of Eclipse Ditto</p>
+
+<p>The slides can be found here: <a href="slides/2019_10_21-eclipse-iot-wg-f2f-ludwigsburg/index.html">2019_10_21-eclipse-iot-wg-f2f-ludwigsburg</a>.</p>
+
+<h2 id="22102018-eclipsecon-europe-2018-in-ludwigsburg">22.10.2018 EclipseCon Europe 2018 in Ludwigsburg</h2>
+
+<p>Topic: Project status update of Eclipse Ditto</p>
+
+<p>The slides can be found here: <a href="slides/2018_10_22-eclipse-iot-wg-f2f-ludwigsburg/index.html">2018_10_22-eclipse-iot-wg-f2f-ludwigsburg</a>.</p>
<h2 id="23052018-iot-hessen-meetup-during-webweek-rhein-main-18">23.05.2018 IoT Hessen Meetup during webweek rhein-main /18</h2>
@@ -1270,17 +1504,15 @@
<p>The code of the showed live demo can be found in our <a href="https://github.com/eclipse/ditto-examples/tree/master/octopus-via-hono">ditto-examples</a>.</p>
-<h2 id="22102018-eclipsecon-europe-2018-in-ludwigsburg">22.10.2018 EclipseCon Europe 2018 in Ludwigsburg</h2>
+<h2 id="07022018-virtual-iot-meetup">07.02.2018 Virtual IoT Meetup</h2>
-<p>Topic: Project status update of Eclipse Ditto</p>
+<p>Topic: “Digital twins go open source: Eclipse Ditto introduction”
+u
+On 07.02.2018 we gave an introduction into Eclipse Ditto via <a href="https://www.meetup.com/Virtual-IoT/events/247048104/">Meetup</a>.</p>
-<p>The slides can be found here: <a href="slides/2018_10_22-eclipse-iot-wg-f2f-ludwigsburg/index.html">2018_10_22-eclipse-iot-wg-f2f-ludwigsburg</a>.</p>
+<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/NpC4ROGqwKc" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen=""></iframe>
-<h2 id="21102019-eclipsecon-europe-2019-in-ludwigsburg">21.10.2019 EclipseCon Europe 2019 in Ludwigsburg</h2>
-
-<p>Topic: Project status update of Eclipse Ditto</p>
-
-<p>The slides can be found here: <a href="slides/2019_10_21-eclipse-iot-wg-f2f-ludwigsburg/index.html">2019_10_21-eclipse-iot-wg-f2f-ludwigsburg</a>.</p>
+<p>The slides can be found here: <a href="slides/2018_02_07-virtualiot-meetup/index.html">2018_02_07-virtualiot-meetup</a>.</p>
<div class="tags">
@@ -1299,7 +1531,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-bindings.html b/1.0/protocol-bindings.html
index 2130cd1..71b56c9 100644
--- a/1.0/protocol-bindings.html
+++ b/1.0/protocol-bindings.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li class="active"><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1301,7 +1522,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-createattribute.html b/1.0/protocol-examples-createattribute.html
index 92f618a..aae0611 100644
--- a/1.0/protocol-examples-createattribute.html
+++ b/1.0/protocol-examples-createattribute.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1304,7 +1525,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-createattributes.html b/1.0/protocol-examples-createattributes.html
index c42753f..6ac4380 100644
--- a/1.0/protocol-examples-createattributes.html
+++ b/1.0/protocol-examples-createattributes.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li class="active"><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1309,7 +1530,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-createdefinition.html b/1.0/protocol-examples-createdefinition.html
index 4fa7393..cacdc66 100644
--- a/1.0/protocol-examples-createdefinition.html
+++ b/1.0/protocol-examples-createdefinition.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1302,7 +1523,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-createfeature.html b/1.0/protocol-examples-createfeature.html
index 1f802f9..1650779 100644
--- a/1.0/protocol-examples-createfeature.html
+++ b/1.0/protocol-examples-createfeature.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1313,7 +1534,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-createfeatures.html b/1.0/protocol-examples-createfeatures.html
index feff10e..ee19bac 100644
--- a/1.0/protocol-examples-createfeatures.html
+++ b/1.0/protocol-examples-createfeatures.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1317,7 +1538,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-createproperties.html b/1.0/protocol-examples-createproperties.html
index 056ad6a..c832fd5 100644
--- a/1.0/protocol-examples-createproperties.html
+++ b/1.0/protocol-examples-createproperties.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1308,7 +1529,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-createproperty.html b/1.0/protocol-examples-createproperty.html
index 9c5356e..28ffadb 100644
--- a/1.0/protocol-examples-createproperty.html
+++ b/1.0/protocol-examples-createproperty.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1298,7 +1519,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-creatething.html b/1.0/protocol-examples-creatething.html
index d1e55e0..8326756 100644
--- a/1.0/protocol-examples-creatething.html
+++ b/1.0/protocol-examples-creatething.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1397,7 +1618,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-createthingdefinition.html b/1.0/protocol-examples-createthingdefinition.html
index e32ebb9..78f808a 100644
--- a/1.0/protocol-examples-createthingdefinition.html
+++ b/1.0/protocol-examples-createthingdefinition.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1282,6 +1503,7 @@
</span></code></pre></div></div>
+
<div class="tags">
</div>
@@ -1298,7 +1520,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-deleteattribute.html b/1.0/protocol-examples-deleteattribute.html
index 4abb70b..27e0260 100644
--- a/1.0/protocol-examples-deleteattribute.html
+++ b/1.0/protocol-examples-deleteattribute.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1296,7 +1517,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-deleteattributes.html b/1.0/protocol-examples-deleteattributes.html
index 064b465..afe8dc3 100644
--- a/1.0/protocol-examples-deleteattributes.html
+++ b/1.0/protocol-examples-deleteattributes.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1296,7 +1517,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-deletedefinition.html b/1.0/protocol-examples-deletedefinition.html
index 1434093..3550177 100644
--- a/1.0/protocol-examples-deletedefinition.html
+++ b/1.0/protocol-examples-deletedefinition.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1296,7 +1517,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-deletefeature.html b/1.0/protocol-examples-deletefeature.html
index 9c59c0b..9e7c5b3 100644
--- a/1.0/protocol-examples-deletefeature.html
+++ b/1.0/protocol-examples-deletefeature.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1296,7 +1517,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-deletefeatures.html b/1.0/protocol-examples-deletefeatures.html
index 7b1cf82..3c73d9e 100644
--- a/1.0/protocol-examples-deletefeatures.html
+++ b/1.0/protocol-examples-deletefeatures.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1296,7 +1517,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-deleteproperties.html b/1.0/protocol-examples-deleteproperties.html
index 3a47e89..599f423 100644
--- a/1.0/protocol-examples-deleteproperties.html
+++ b/1.0/protocol-examples-deleteproperties.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1296,7 +1517,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-deleteproperty.html b/1.0/protocol-examples-deleteproperty.html
index 6542bfb..8c9b1c7 100644
--- a/1.0/protocol-examples-deleteproperty.html
+++ b/1.0/protocol-examples-deleteproperty.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1296,7 +1517,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-deletething.html b/1.0/protocol-examples-deletething.html
index 02a3c35..04e2378 100644
--- a/1.0/protocol-examples-deletething.html
+++ b/1.0/protocol-examples-deletething.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1296,7 +1517,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-deletethingdefinition.html b/1.0/protocol-examples-deletethingdefinition.html
index 5a3c04a..74c4c58 100644
--- a/1.0/protocol-examples-deletethingdefinition.html
+++ b/1.0/protocol-examples-deletethingdefinition.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1296,7 +1517,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-errorresponses.html b/1.0/protocol-examples-errorresponses.html
index 0232990..13118dd 100644
--- a/1.0/protocol-examples-errorresponses.html
+++ b/1.0/protocol-examples-errorresponses.html
@@ -5,7 +5,7 @@
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="description" content="">
-<meta name="keywords" content=" examples, create attribute">
+<meta name="keywords" content=" examples, things error responses, error responses">
<title> Error responses • Eclipse Ditto • a digital twin framework</title>
<link rel="stylesheet" href="css/syntax.css">
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li class="active"><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li class="active"><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1731,7 +1952,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-modifyattribute.html b/1.0/protocol-examples-modifyattribute.html
index 33a2f15..4d61e01 100644
--- a/1.0/protocol-examples-modifyattribute.html
+++ b/1.0/protocol-examples-modifyattribute.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1304,7 +1525,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-modifyattributes.html b/1.0/protocol-examples-modifyattributes.html
index 4a7e6c8..736a4d1 100644
--- a/1.0/protocol-examples-modifyattributes.html
+++ b/1.0/protocol-examples-modifyattributes.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1309,7 +1530,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-modifydefinition.html b/1.0/protocol-examples-modifydefinition.html
index 01addb6..c032089 100644
--- a/1.0/protocol-examples-modifydefinition.html
+++ b/1.0/protocol-examples-modifydefinition.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1302,7 +1523,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-modifyfeature.html b/1.0/protocol-examples-modifyfeature.html
index 80fa475..f39d096 100644
--- a/1.0/protocol-examples-modifyfeature.html
+++ b/1.0/protocol-examples-modifyfeature.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1313,7 +1534,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-modifyfeatures.html b/1.0/protocol-examples-modifyfeatures.html
index b0045a1..676139a 100644
--- a/1.0/protocol-examples-modifyfeatures.html
+++ b/1.0/protocol-examples-modifyfeatures.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1317,7 +1538,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-modifypolicyid.html b/1.0/protocol-examples-modifypolicyid.html
new file mode 100644
index 0000000..fb8a65b
--- /dev/null
+++ b/1.0/protocol-examples-modifypolicyid.html
@@ -0,0 +1,1580 @@
+<!DOCTYPE html>
+<html>
+<head>
+ <meta charset="utf-8">
+<meta http-equiv="X-UA-Compatible" content="IE=edge">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="description" content="">
+<meta name="keywords" content=" examples, modify policy id">
+<title> Modify the policy ID of a Thing • Eclipse Ditto • a digital twin framework</title>
+
+<link rel="stylesheet" href="css/syntax.css">
+<link rel="stylesheet" type="text/css" href="//cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/modern-business.css">
+<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/customstyles.css">
+<link rel="stylesheet" href="css/boxshadowproperties.css">
+<link rel="stylesheet" href="css/theme-ditto.css">
+<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:400,700|Source+Code+Pro:300,600|Titillium+Web:400,600,700">
+
+<script src="//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.4/jquery.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/js/bootstrap.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/anchor-js/2.0.0/anchor.min.js" crossorigin="anonymous"></script>
+<script src="js/toc.js"></script>
+<script src="js/customscripts.js"></script>
+
+<script type="application/ld+json">
+{
+ "@context": "http://schema.org",
+ "@type": "Organization",
+ "url": "https://eclipse.org/ditto/",
+ "logo": "https://eclipse.org/ditto/images/ditto.svg"
+}
+</script>
+
+<link rel="icon" type="image/png" href="images/favicon-16x16.png" sizes="16x16">
+<link rel="icon" type="image/png" href="images/favicon-32x32.png" sizes="32x32">
+<link rel="icon" type="image/png" href="images/favicon-96x96.png" sizes="96x96">
+
+<link rel="alternate" type="application/rss+xml" title="Eclipse Ditto Blog" href="https://www.eclipse.org/ditto/feed.xml">
+
+<!-- Eclipse Foundation cookie consent: -->
+<link rel="stylesheet" type="text/css" href="//www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css" />
+<script src="//www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+ <script>
+ $(document).ready(function() {
+ $("#tg-sb-link").click(function() {
+ $("#tg-sb-sidebar").toggle();
+ $("#tg-sb-content").toggleClass('col-md-9');
+ $("#tg-sb-content").toggleClass('col-md-12');
+ $("#tg-sb-icon").toggleClass('fa-toggle-on');
+ $("#tg-sb-icon").toggleClass('fa-toggle-off');
+ });
+ });
+ </script>
+</head>
+
+
+<script>
+ (function(w,d,s,l,i){
+ w[l]=w[l]||[];
+ w[l].push({'gtm.start':
+ new Date().getTime(),event:'gtm.js'});
+ var f=d.getElementsByTagName(s)[0],
+ j=d.createElement(s),
+ dl=l!='dataLayer'?'&l='+l:'';
+ j.async=true;
+ j.src='https://www.googletagmanager.com/gtm.js?id='+i+dl;
+ f.parentNode.insertBefore(j,f);
+ })(window,document,'script','dataLayer','GTM-5WLCZXC');
+</script>
+
+
+
+<body>
+<!-- Navigation -->
+<nav class="navbar navbar-inverse navbar-fixed-top">
+ <div class="container topnavlinks">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-ditto-home" href="index.html"> <img src="images/ditto_allwhite_symbolonly.svg" class="ditto-navbar-symbol" alt="Home"> <img src="images/ditto_allwhite_textonly.svg" class="ditto-navbar-symbol-text" alt="Ditto"></a>
+ </div>
+ <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
+ <ul class="nav navbar-nav navbar-right">
+ <!-- toggle sidebar button -->
+ <!--<li><a id="tg-sb-link" href="#"><i id="tg-sb-icon" class="fa fa-toggle-on"></i> Nav</a></li>-->
+ <!-- entries without drop-downs appear here -->
+
+
+
+
+
+
+
+ <li><a href="blog.html">Blog</a></li>
+
+
+
+ <li><a href="intro-overview.html">Documentation</a></li>
+
+
+
+ <li><a href="http-api-doc.html">HTTP API</a></li>
+
+
+
+ <li><a href="https://ditto.eclipse.org" target="_blank">Sandbox</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">GitHub</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">GitHub examples</a></li>
+
+
+
+ <!-- entries with drop-downs appear here -->
+ <!-- conditional logic to control which topnav appears for the audience defined in the configuration file.-->
+
+
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Links<b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+
+ <li><a href="https://projects.eclipse.org/projects/iot.ditto" target="_blank">Eclipse Ditto Project</a></li>
+
+
+
+ <li><a href="https://www.eclipse.org/forums/index.php/f/364/" target="_blank">Forum</a></li>
+
+
+
+ <li><a href="https://ci.eclipse.org/ditto/" target="_blank">Jenkins</a></li>
+
+
+
+ <li><a href="https://dev.eclipse.org/mhonarc/lists/ditto-dev/" target="_blank">Mailing list archives</a></li>
+
+
+
+ <li><a href="https://gitter.im/eclipse/ditto" target="_blank">Gitter.im chat</a></li>
+
+
+ </ul>
+ </li>
+
+
+
+ <!--comment out this block if you want to hide search-->
+ <li>
+ <!--start search-->
+ <div id="search-demo-container">
+ <input type="text" id="search-input" placeholder="search...">
+ <ul id="results-container"></ul>
+ </div>
+ <script src="//cdnjs.cloudflare.com/ajax/libs/simple-jekyll-search/0.0.9/jekyll-search.js" type="text/javascript"></script>
+ <script type="text/javascript">
+ SimpleJekyllSearch.init({
+ searchInput: document.getElementById('search-input'),
+ resultsContainer: document.getElementById('results-container'),
+ dataSource: 'search.json',
+ searchResultTemplate: '<li><a href="{url}" title="Modify the policy ID of a Thing">{title}</a></li>',
+ noResultsText: 'No results found.',
+ limit: 10,
+ fuzzy: true,
+ })
+ </script>
+ <!--end search-->
+ </li>
+ </ul>
+ </div>
+ </div>
+ <!-- /.container -->
+</nav>
+
+<!-- Page Content -->
+<div class="container">
+ <div id="main">
+ <!-- Content Row -->
+ <div class="row">
+
+
+ <!-- Sidebar Column -->
+ <div class="col-md-3" id="tg-sb-sidebar">
+
+
+<ul id="mysidebar" class="nav">
+ <li class="sidebarTitle">
+ <label for="docVersion">Eclipse Ditto version:</label>
+ <div class="select-wrapper">
+ <select id="docVersion" name="docVersion">
+
+ <option value="">development</option>
+
+ <option value="1.0">1.0</option>
+
+ <option value="1.1">1.1</option>
+
+ </select>
+ </div>
+ <div id="dev-warning">
+ <div markdown="span" class="alert alert-warning" role="alert" style="font-size:0.6em"><i class="fa fa-warning"></i> <b>Important:</b> This documentation reflects the latest 'development'. You might want to choose a released version.</div>
+ </div>
+ </li>
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Introduction</a>
+ <ul>
+
+
+
+ <li><a href="intro-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="intro-digitaltwins.html">Digital twins</a></li>
+
+
+
+
+
+
+ <li><a href="intro-hello-world.html">Hello world</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Release Notes</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_100.html">1.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_090.html">0.9.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_080.html">0.8.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Milestone releases</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_100-M2.html">1.0.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_100-M1a.html">1.0.0-M1a</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M2.html">0.9.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M1.html">0.9.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M3.html">0.8.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M2.html">0.8.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M1.html">0.8.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M2.html">0.3.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M1.html">0.3.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_020-M1.html">0.2.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M3.html">0.1.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M1.html">0.1.0-M1</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Installation</a>
+ <ul>
+
+
+
+ <li><a href="installation-building.html">Building Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-running.html">Running Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-operating.html">Operating Ditto</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Basic concepts</a>
+ <ul>
+
+
+
+ <li><a href="basic-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Model entities</a>
+ <ul>
+
+
+
+ <li><a href="basic-thing.html">Thing</a></li>
+
+
+
+
+
+ <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
+
+
+
+
+
+ <li><a href="basic-feature.html">Feature</a></li>
+
+
+
+
+
+ <li><a href="basic-policy.html">Policy</a></li>
+
+
+
+
+
+ <li><a href="basic-namespaces-and-names.html">Namespaces and Names</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-auth.html">Authentication and Authorization</a></li>
+
+
+
+
+
+
+ <li><a href="basic-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="basic-signals.html">Signals</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Signal types</a>
+ <ul>
+
+
+
+ <li><a href="basic-signals-command.html">Command</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-commandresponse.html">Command response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-errorresponse.html">Error response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-event.html">Event</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-apis.html">APIs</a></li>
+
+
+
+
+
+
+ <li><a href="basic-connections.html">Connections</a></li>
+
+
+
+
+
+
+ <li><a href="basic-placeholders.html">Placeholders</a></li>
+
+
+
+
+
+
+ <li><a href="basic-changenotifications.html">Change notifications</a></li>
+
+
+
+
+
+
+ <li><a href="basic-rql.html">RQL expressions</a></li>
+
+
+
+
+
+
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
+ <li><a href="basic-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Architecture</a>
+ <ul>
+
+
+
+ <li><a href="architecture-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Services</a>
+ <ul>
+
+
+
+ <li><a href="architecture-services-policies.html">Policies</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things.html">Things</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things-search.html">Things-Search</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-connectivity.html">Connectivity</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-concierge.html">Concierge</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-gateway.html">Gateway</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>HTTP API</a>
+ <ul>
+
+
+
+ <li><a href="httpapi-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-concepts.html">Concepts</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-protocol-bindings-websocket.html">WebSocket protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-sse.html">Server sent events</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Connectivity API</a>
+ <ul>
+
+
+
+ <li><a href="connectivity-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-manage-connections.html">Manage connections</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp091.html">AMQP 0.9.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp10.html">AMQP 1.0 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-kafka2.html">Kafka 2.x protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-mapping.html">Payload mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-header-mapping.html">Header mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-tls-certificates.html">TLS certificates</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Client SDK</a>
+ <ul>
+
+
+
+ <li><a href="client-sdk-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-java.html">Java</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-javascript.html">JavaScript</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Ditto Protocol</a>
+ <ul>
+
+
+
+ <li><a href="protocol-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-twinlive.html">Twin/live channel</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification.html">Specification</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-topic.html">Protocol topic</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-things.html">Things group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-delete.html">Delete</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ search/messages</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-search.html">Search</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-messages.html">Messages</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-bindings.html">Bindings</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-examples.html">Examples</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-creatething.html">Create a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletething.html">Delete a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifything.html">Modify a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievething.html">Retrieve a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethings.html">Retrieve multiple Things</a></li>
+
+
+
+
+
+ <li class="active"><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattributes.html">Delete Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattributes.html">Modify Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattributes.html">Retrieve Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattribute.html">Create a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattribute.html">Delete a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattribute.html">Modify a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattribute.html">Retrieve a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createthingdefinition.html">Create a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletethingdefinition.html">Delete a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifythingdefinition.html">Modify a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethingdefinition.html">Retrieve a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeatures.html">Create Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeatures.html">Delete Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeatures.html">Modify Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeatures.html">Retrieve Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeature.html">Create a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeature.html">Delete a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeature.html">Modify a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeature.html">Retrieve a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdefinition.html">Create Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedefinition.html">Delete Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydefinition.html">Modify Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedefinition.html">Retrieve Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperties.html">Create Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperties.html">Delete Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperties.html">Modify Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperties.html">Retrieve Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperty.html">Create a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperty.html">Delete a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperty.html">Modify a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperty.html">Retrieve a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li><a href="sandbox.html">Sandbox</a></li>
+
+
+
+
+
+ <li><a href="presentations.html">Presentations</a></li>
+
+
+
+
+
+ <li><a href="glossary.html">Glossary</a></li>
+
+
+
+
+
+ <li><a href="feedback.html">Feedback</a></li>
+
+
+
+
+
+ <p class="external">
+ <a href="#" id="collapseAll">Collapse All</a> | <a href="#" id="expandAll">Expand All</a>
+ </p>
+
+</ul>
+
+<!-- this highlights the active parent class in the sidebar. this is critical so that the parent expands when you're viewing a page. This must appear below the sidebar code above. Otherwise, if placed inside customscripts.js, the script runs before the sidebar code runs and the class never gets inserted.-->
+<script>$("li.active").parents('li').toggleClass("active");
+
+$(function() {
+ $("#dev-warning").hide();
+ changeSelectedDocVersionDropdownSelection($("#docVersion")[0]);
+ $("#docVersion").change(changeSelectedDocVersion);
+});
+
+function changeSelectedDocVersionDropdownSelection(element) {
+ var pathName = window.location.pathname;
+
+ var versionOptions = element.options;
+ for (var i = 0; i < versionOptions.length; i++) {
+ var versionValue = versionOptions[i].value;
+ if ((versionValue !== "") && pathName.startsWith("/ditto/"+versionValue+"/")) {
+ $("#docVersion").val(versionValue).change();
+ return;
+ }
+ }
+ // fallback: dev with "empty" version value:
+ $("#docVersion").val("").change();
+ $("#dev-warning").show();
+}
+function changeSelectedDocVersion() {
+ var versionValue = $('#docVersion').val();
+ var remainingPath = window.location.pathname.replace("/ditto/", "");
+ var versionMatch = remainingPath.match("([0-9].[0.9])/(.*)");
+ if (versionValue === "" && !versionMatch) {
+ // do nothing, we're already on the correct "dev" version
+ } else if (versionMatch && (versionValue === versionMatch[1])) {
+ // do nothing, we're already on the correct version
+ } else {
+ if (versionValue === "" && versionMatch) {
+ window.location.pathname = "ditto/" + versionMatch[2];
+ } else if (versionValue === "") {
+ window.location.pathname = "ditto/" + remainingPath;
+ } else if (versionMatch) {
+ window.location.pathname = "ditto/" + versionValue + "/" + versionMatch[2];
+ } else {
+ window.location.pathname = "ditto/" + versionValue + "/" + remainingPath;
+ }
+ }
+}
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Modify the policy ID of a Thing</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+
+
+
+<!-- this handles the automatic toc. use ## for subheads to auto-generate the on-page minitoc. if you use html tags, you must supply an ID for the heading element in order for it to appear in the minitoc. -->
+<script>
+$( document ).ready(function() {
+ // Handler for .ready() called.
+
+$('#toc').toc({ minimumHeaders: 0, listType: 'ul', showSpeed: 0, headers: 'h2,h3,h4' });
+
+/* this offset helps account for the space taken up by the floating toolbar. */
+$('#toc').on('click', 'a', function() {
+ var target = $(this.getAttribute('href'))
+ , scroll_target = target.offset().top
+
+ $(window).scrollTop(scroll_target - 10);
+ return false
+})
+
+});
+</script>
+
+<div id="toc"></div>
+
+
+
+
+
+
+
+
+
+
+<h2 id="modifypolicyid">ModifyPolicyId</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/xdk_53/things/twin/commands/modify"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/policyId"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme:the_policy_id"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="modifypolicyidresponse">ModifyPolicyIdResponse</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/xdk_53/things/twin/commands/modify"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/policyId"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">204</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="modifypolicyidresponse-when-thing-had-no-policy-id-yet">ModifyPolicyIdResponse when Thing had no Policy ID yet</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/xdk_53/things/twin/commands/modify"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/policyId"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme:the_policy_id"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">201</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="policyidcreated">PolicyIdCreated</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/xdk_53/things/twin/events/created"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/policyId"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme:the_policy_id"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"revision"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="policyidmodified">PolicyIdModified</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/xdk_53/things/twin/events/modified"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/policyId"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme:the_policy_id"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"revision"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+
+
+ <div class="tags">
+
+ </div>
+
+</div>
+
+<hr class="shaded"/>
+
+<footer>
+ <div class="row">
+ <div class="col-lg-12 footer">
+ <div class="logo">
+ <a href="https://eclipse.org"><img src="images/eclipse_foundation_logo.svg" alt="Eclipse logo"/></a>
+ </div>
+ <p class="notice">
+ ©2020 Eclipse Ditto.
+ Site last generated: Jul 1, 2020 <br />
+ </p>
+ <div class="quickLinks">
+ <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
+ > Privacy Policy
+ </a>
+ <a href="https://www.eclipse.org/legal/termsofuse.php" target="_blank">
+ > Terms of Use
+ </a>
+ <a href="https://www.eclipse.org/legal/copyright.php" target="_blank">
+ > Copyright Agent
+ </a>
+ <a href="https://www.eclipse.org/legal" target="_blank">
+ > Legal
+ </a>
+ <a href="https://www.eclipse.org/legal/epl-2.0/" target="_blank">
+ > License
+ </a>
+ <a href="https://eclipse.org/security" target="_blank">
+ > Report a Vulnerability
+ </a>
+ </div>
+ </div>
+ </div>
+</footer>
+
+
+ </div>
+ <!-- /.row -->
+</div>
+<!-- /.container -->
+</div>
+<!-- /#main -->
+ </div>
+
+</body>
+</html>
diff --git a/1.0/protocol-examples-modifyproperties.html b/1.0/protocol-examples-modifyproperties.html
index e1fd15e..307afdc 100644
--- a/1.0/protocol-examples-modifyproperties.html
+++ b/1.0/protocol-examples-modifyproperties.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1308,7 +1529,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-modifyproperty.html b/1.0/protocol-examples-modifyproperty.html
index 39eee76..11cfb1e 100644
--- a/1.0/protocol-examples-modifyproperty.html
+++ b/1.0/protocol-examples-modifyproperty.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1298,7 +1519,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-modifything.html b/1.0/protocol-examples-modifything.html
index 19d7e2f..16a124a 100644
--- a/1.0/protocol-examples-modifything.html
+++ b/1.0/protocol-examples-modifything.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1361,6 +1582,7 @@
</span></code></pre></div></div>
+
<div class="tags">
</div>
@@ -1377,7 +1599,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-modifythingdefinition.html b/1.0/protocol-examples-modifythingdefinition.html
index 30004fe..f4c21c5 100644
--- a/1.0/protocol-examples-modifythingdefinition.html
+++ b/1.0/protocol-examples-modifythingdefinition.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1298,7 +1519,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-policies-createpolicy.html b/1.0/protocol-examples-policies-createpolicy.html
new file mode 100644
index 0000000..bd76147
--- /dev/null
+++ b/1.0/protocol-examples-policies-createpolicy.html
@@ -0,0 +1,1592 @@
+<!DOCTYPE html>
+<html>
+<head>
+ <meta charset="utf-8">
+<meta http-equiv="X-UA-Compatible" content="IE=edge">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="description" content="">
+<meta name="keywords" content=" examples, create policy">
+<title> Create a Policy • Eclipse Ditto • a digital twin framework</title>
+
+<link rel="stylesheet" href="css/syntax.css">
+<link rel="stylesheet" type="text/css" href="//cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/modern-business.css">
+<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/customstyles.css">
+<link rel="stylesheet" href="css/boxshadowproperties.css">
+<link rel="stylesheet" href="css/theme-ditto.css">
+<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:400,700|Source+Code+Pro:300,600|Titillium+Web:400,600,700">
+
+<script src="//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.4/jquery.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/js/bootstrap.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/anchor-js/2.0.0/anchor.min.js" crossorigin="anonymous"></script>
+<script src="js/toc.js"></script>
+<script src="js/customscripts.js"></script>
+
+<script type="application/ld+json">
+{
+ "@context": "http://schema.org",
+ "@type": "Organization",
+ "url": "https://eclipse.org/ditto/",
+ "logo": "https://eclipse.org/ditto/images/ditto.svg"
+}
+</script>
+
+<link rel="icon" type="image/png" href="images/favicon-16x16.png" sizes="16x16">
+<link rel="icon" type="image/png" href="images/favicon-32x32.png" sizes="32x32">
+<link rel="icon" type="image/png" href="images/favicon-96x96.png" sizes="96x96">
+
+<link rel="alternate" type="application/rss+xml" title="Eclipse Ditto Blog" href="https://www.eclipse.org/ditto/feed.xml">
+
+<!-- Eclipse Foundation cookie consent: -->
+<link rel="stylesheet" type="text/css" href="//www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css" />
+<script src="//www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+ <script>
+ $(document).ready(function() {
+ $("#tg-sb-link").click(function() {
+ $("#tg-sb-sidebar").toggle();
+ $("#tg-sb-content").toggleClass('col-md-9');
+ $("#tg-sb-content").toggleClass('col-md-12');
+ $("#tg-sb-icon").toggleClass('fa-toggle-on');
+ $("#tg-sb-icon").toggleClass('fa-toggle-off');
+ });
+ });
+ </script>
+</head>
+
+
+<script>
+ (function(w,d,s,l,i){
+ w[l]=w[l]||[];
+ w[l].push({'gtm.start':
+ new Date().getTime(),event:'gtm.js'});
+ var f=d.getElementsByTagName(s)[0],
+ j=d.createElement(s),
+ dl=l!='dataLayer'?'&l='+l:'';
+ j.async=true;
+ j.src='https://www.googletagmanager.com/gtm.js?id='+i+dl;
+ f.parentNode.insertBefore(j,f);
+ })(window,document,'script','dataLayer','GTM-5WLCZXC');
+</script>
+
+
+
+<body>
+<!-- Navigation -->
+<nav class="navbar navbar-inverse navbar-fixed-top">
+ <div class="container topnavlinks">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-ditto-home" href="index.html"> <img src="images/ditto_allwhite_symbolonly.svg" class="ditto-navbar-symbol" alt="Home"> <img src="images/ditto_allwhite_textonly.svg" class="ditto-navbar-symbol-text" alt="Ditto"></a>
+ </div>
+ <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
+ <ul class="nav navbar-nav navbar-right">
+ <!-- toggle sidebar button -->
+ <!--<li><a id="tg-sb-link" href="#"><i id="tg-sb-icon" class="fa fa-toggle-on"></i> Nav</a></li>-->
+ <!-- entries without drop-downs appear here -->
+
+
+
+
+
+
+
+ <li><a href="blog.html">Blog</a></li>
+
+
+
+ <li><a href="intro-overview.html">Documentation</a></li>
+
+
+
+ <li><a href="http-api-doc.html">HTTP API</a></li>
+
+
+
+ <li><a href="https://ditto.eclipse.org" target="_blank">Sandbox</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">GitHub</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">GitHub examples</a></li>
+
+
+
+ <!-- entries with drop-downs appear here -->
+ <!-- conditional logic to control which topnav appears for the audience defined in the configuration file.-->
+
+
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Links<b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+
+ <li><a href="https://projects.eclipse.org/projects/iot.ditto" target="_blank">Eclipse Ditto Project</a></li>
+
+
+
+ <li><a href="https://www.eclipse.org/forums/index.php/f/364/" target="_blank">Forum</a></li>
+
+
+
+ <li><a href="https://ci.eclipse.org/ditto/" target="_blank">Jenkins</a></li>
+
+
+
+ <li><a href="https://dev.eclipse.org/mhonarc/lists/ditto-dev/" target="_blank">Mailing list archives</a></li>
+
+
+
+ <li><a href="https://gitter.im/eclipse/ditto" target="_blank">Gitter.im chat</a></li>
+
+
+ </ul>
+ </li>
+
+
+
+ <!--comment out this block if you want to hide search-->
+ <li>
+ <!--start search-->
+ <div id="search-demo-container">
+ <input type="text" id="search-input" placeholder="search...">
+ <ul id="results-container"></ul>
+ </div>
+ <script src="//cdnjs.cloudflare.com/ajax/libs/simple-jekyll-search/0.0.9/jekyll-search.js" type="text/javascript"></script>
+ <script type="text/javascript">
+ SimpleJekyllSearch.init({
+ searchInput: document.getElementById('search-input'),
+ resultsContainer: document.getElementById('results-container'),
+ dataSource: 'search.json',
+ searchResultTemplate: '<li><a href="{url}" title="Create a Policy">{title}</a></li>',
+ noResultsText: 'No results found.',
+ limit: 10,
+ fuzzy: true,
+ })
+ </script>
+ <!--end search-->
+ </li>
+ </ul>
+ </div>
+ </div>
+ <!-- /.container -->
+</nav>
+
+<!-- Page Content -->
+<div class="container">
+ <div id="main">
+ <!-- Content Row -->
+ <div class="row">
+
+
+ <!-- Sidebar Column -->
+ <div class="col-md-3" id="tg-sb-sidebar">
+
+
+<ul id="mysidebar" class="nav">
+ <li class="sidebarTitle">
+ <label for="docVersion">Eclipse Ditto version:</label>
+ <div class="select-wrapper">
+ <select id="docVersion" name="docVersion">
+
+ <option value="">development</option>
+
+ <option value="1.0">1.0</option>
+
+ <option value="1.1">1.1</option>
+
+ </select>
+ </div>
+ <div id="dev-warning">
+ <div markdown="span" class="alert alert-warning" role="alert" style="font-size:0.6em"><i class="fa fa-warning"></i> <b>Important:</b> This documentation reflects the latest 'development'. You might want to choose a released version.</div>
+ </div>
+ </li>
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Introduction</a>
+ <ul>
+
+
+
+ <li><a href="intro-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="intro-digitaltwins.html">Digital twins</a></li>
+
+
+
+
+
+
+ <li><a href="intro-hello-world.html">Hello world</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Release Notes</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_100.html">1.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_090.html">0.9.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_080.html">0.8.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Milestone releases</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_100-M2.html">1.0.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_100-M1a.html">1.0.0-M1a</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M2.html">0.9.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M1.html">0.9.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M3.html">0.8.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M2.html">0.8.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M1.html">0.8.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M2.html">0.3.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M1.html">0.3.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_020-M1.html">0.2.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M3.html">0.1.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M1.html">0.1.0-M1</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Installation</a>
+ <ul>
+
+
+
+ <li><a href="installation-building.html">Building Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-running.html">Running Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-operating.html">Operating Ditto</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Basic concepts</a>
+ <ul>
+
+
+
+ <li><a href="basic-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Model entities</a>
+ <ul>
+
+
+
+ <li><a href="basic-thing.html">Thing</a></li>
+
+
+
+
+
+ <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
+
+
+
+
+
+ <li><a href="basic-feature.html">Feature</a></li>
+
+
+
+
+
+ <li><a href="basic-policy.html">Policy</a></li>
+
+
+
+
+
+ <li><a href="basic-namespaces-and-names.html">Namespaces and Names</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-auth.html">Authentication and Authorization</a></li>
+
+
+
+
+
+
+ <li><a href="basic-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="basic-signals.html">Signals</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Signal types</a>
+ <ul>
+
+
+
+ <li><a href="basic-signals-command.html">Command</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-commandresponse.html">Command response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-errorresponse.html">Error response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-event.html">Event</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-apis.html">APIs</a></li>
+
+
+
+
+
+
+ <li><a href="basic-connections.html">Connections</a></li>
+
+
+
+
+
+
+ <li><a href="basic-placeholders.html">Placeholders</a></li>
+
+
+
+
+
+
+ <li><a href="basic-changenotifications.html">Change notifications</a></li>
+
+
+
+
+
+
+ <li><a href="basic-rql.html">RQL expressions</a></li>
+
+
+
+
+
+
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
+ <li><a href="basic-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Architecture</a>
+ <ul>
+
+
+
+ <li><a href="architecture-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Services</a>
+ <ul>
+
+
+
+ <li><a href="architecture-services-policies.html">Policies</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things.html">Things</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things-search.html">Things-Search</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-connectivity.html">Connectivity</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-concierge.html">Concierge</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-gateway.html">Gateway</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>HTTP API</a>
+ <ul>
+
+
+
+ <li><a href="httpapi-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-concepts.html">Concepts</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-protocol-bindings-websocket.html">WebSocket protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-sse.html">Server sent events</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Connectivity API</a>
+ <ul>
+
+
+
+ <li><a href="connectivity-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-manage-connections.html">Manage connections</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp091.html">AMQP 0.9.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp10.html">AMQP 1.0 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-kafka2.html">Kafka 2.x protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-mapping.html">Payload mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-header-mapping.html">Header mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-tls-certificates.html">TLS certificates</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Client SDK</a>
+ <ul>
+
+
+
+ <li><a href="client-sdk-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-java.html">Java</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-javascript.html">JavaScript</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Ditto Protocol</a>
+ <ul>
+
+
+
+ <li><a href="protocol-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-twinlive.html">Twin/live channel</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification.html">Specification</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-topic.html">Protocol topic</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-things.html">Things group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-delete.html">Delete</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ search/messages</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-search.html">Search</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-messages.html">Messages</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-bindings.html">Bindings</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-examples.html">Examples</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-creatething.html">Create a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletething.html">Delete a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifything.html">Modify a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievething.html">Retrieve a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethings.html">Retrieve multiple Things</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattributes.html">Delete Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattributes.html">Modify Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattributes.html">Retrieve Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattribute.html">Create a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattribute.html">Delete a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattribute.html">Modify a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattribute.html">Retrieve a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createthingdefinition.html">Create a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletethingdefinition.html">Delete a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifythingdefinition.html">Modify a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethingdefinition.html">Retrieve a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeatures.html">Create Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeatures.html">Delete Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeatures.html">Modify Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeatures.html">Retrieve Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeature.html">Create a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeature.html">Delete a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeature.html">Modify a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeature.html">Retrieve a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdefinition.html">Create Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedefinition.html">Delete Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydefinition.html">Modify Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedefinition.html">Retrieve Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperties.html">Create Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperties.html">Delete Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperties.html">Modify Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperties.html">Retrieve Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperty.html">Create a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperty.html">Delete a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperty.html">Modify a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperty.html">Retrieve a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li class="active"><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li><a href="sandbox.html">Sandbox</a></li>
+
+
+
+
+
+ <li><a href="presentations.html">Presentations</a></li>
+
+
+
+
+
+ <li><a href="glossary.html">Glossary</a></li>
+
+
+
+
+
+ <li><a href="feedback.html">Feedback</a></li>
+
+
+
+
+
+ <p class="external">
+ <a href="#" id="collapseAll">Collapse All</a> | <a href="#" id="expandAll">Expand All</a>
+ </p>
+
+</ul>
+
+<!-- this highlights the active parent class in the sidebar. this is critical so that the parent expands when you're viewing a page. This must appear below the sidebar code above. Otherwise, if placed inside customscripts.js, the script runs before the sidebar code runs and the class never gets inserted.-->
+<script>$("li.active").parents('li').toggleClass("active");
+
+$(function() {
+ $("#dev-warning").hide();
+ changeSelectedDocVersionDropdownSelection($("#docVersion")[0]);
+ $("#docVersion").change(changeSelectedDocVersion);
+});
+
+function changeSelectedDocVersionDropdownSelection(element) {
+ var pathName = window.location.pathname;
+
+ var versionOptions = element.options;
+ for (var i = 0; i < versionOptions.length; i++) {
+ var versionValue = versionOptions[i].value;
+ if ((versionValue !== "") && pathName.startsWith("/ditto/"+versionValue+"/")) {
+ $("#docVersion").val(versionValue).change();
+ return;
+ }
+ }
+ // fallback: dev with "empty" version value:
+ $("#docVersion").val("").change();
+ $("#dev-warning").show();
+}
+function changeSelectedDocVersion() {
+ var versionValue = $('#docVersion').val();
+ var remainingPath = window.location.pathname.replace("/ditto/", "");
+ var versionMatch = remainingPath.match("([0-9].[0.9])/(.*)");
+ if (versionValue === "" && !versionMatch) {
+ // do nothing, we're already on the correct "dev" version
+ } else if (versionMatch && (versionValue === versionMatch[1])) {
+ // do nothing, we're already on the correct version
+ } else {
+ if (versionValue === "" && versionMatch) {
+ window.location.pathname = "ditto/" + versionMatch[2];
+ } else if (versionValue === "") {
+ window.location.pathname = "ditto/" + remainingPath;
+ } else if (versionMatch) {
+ window.location.pathname = "ditto/" + versionValue + "/" + versionMatch[2];
+ } else {
+ window.location.pathname = "ditto/" + versionValue + "/" + remainingPath;
+ }
+ }
+}
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Create a Policy</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+
+
+
+<!-- this handles the automatic toc. use ## for subheads to auto-generate the on-page minitoc. if you use html tags, you must supply an ID for the heading element in order for it to appear in the minitoc. -->
+<script>
+$( document ).ready(function() {
+ // Handler for .ready() called.
+
+$('#toc').toc({ minimumHeaders: 0, listType: 'ul', showSpeed: 0, headers: 'h2,h3,h4' });
+
+/* this offset helps account for the space taken up by the floating toolbar. */
+$('#toc').on('click', 'a', function() {
+ var target = $(this.getAttribute('href'))
+ , scroll_target = target.offset().top
+
+ $(window).scrollTop(scroll_target - 10);
+ return false
+})
+
+});
+</script>
+
+<div id="toc"></div>
+
+
+
+
+
+
+
+
+
+
+<h2 id="createpolicy">CreatePolicy</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/the_policy_id/policies/commands/create"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"policyId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme:the_policy_id"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"entries"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"the_label"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"subjects"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"google:the_subjectid"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"yourSubjectTypeDescription"</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"resources"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"thing:/the_resource_path"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"grant"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
+ </span><span class="s2">"READ"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"WRITE"</span><span class="w">
+ </span><span class="p">],</span><span class="w">
+ </span><span class="s2">"revoke"</span><span class="p">:</span><span class="w"> </span><span class="p">[]</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="createpolicyresponse">CreatePolicyResponse</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/the_policy_id/policies/commands/create"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"policyId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme:the_policy_id"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"entries"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"the_label"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"subjects"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"google:the_subjectid"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"yourSubjectTypeDescription"</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"resources"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"thing:/the_resource_path"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"grant"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
+ </span><span class="s2">"READ"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"WRITE"</span><span class="w">
+ </span><span class="p">],</span><span class="w">
+ </span><span class="s2">"revoke"</span><span class="p">:</span><span class="w"> </span><span class="p">[]</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">201</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+
+
+ <div class="tags">
+
+ </div>
+
+</div>
+
+<hr class="shaded"/>
+
+<footer>
+ <div class="row">
+ <div class="col-lg-12 footer">
+ <div class="logo">
+ <a href="https://eclipse.org"><img src="images/eclipse_foundation_logo.svg" alt="Eclipse logo"/></a>
+ </div>
+ <p class="notice">
+ ©2020 Eclipse Ditto.
+ Site last generated: Jul 1, 2020 <br />
+ </p>
+ <div class="quickLinks">
+ <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
+ > Privacy Policy
+ </a>
+ <a href="https://www.eclipse.org/legal/termsofuse.php" target="_blank">
+ > Terms of Use
+ </a>
+ <a href="https://www.eclipse.org/legal/copyright.php" target="_blank">
+ > Copyright Agent
+ </a>
+ <a href="https://www.eclipse.org/legal" target="_blank">
+ > Legal
+ </a>
+ <a href="https://www.eclipse.org/legal/epl-2.0/" target="_blank">
+ > License
+ </a>
+ <a href="https://eclipse.org/security" target="_blank">
+ > Report a Vulnerability
+ </a>
+ </div>
+ </div>
+ </div>
+</footer>
+
+
+ </div>
+ <!-- /.row -->
+</div>
+<!-- /.container -->
+</div>
+<!-- /#main -->
+ </div>
+
+</body>
+</html>
diff --git a/1.0/protocol-examples-policies-createpolicyentry.html b/1.0/protocol-examples-policies-createpolicyentry.html
new file mode 100644
index 0000000..57afcc4
--- /dev/null
+++ b/1.0/protocol-examples-policies-createpolicyentry.html
@@ -0,0 +1,1568 @@
+<!DOCTYPE html>
+<html>
+<head>
+ <meta charset="utf-8">
+<meta http-equiv="X-UA-Compatible" content="IE=edge">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="description" content="">
+<meta name="keywords" content=" examples, create policy entry">
+<title> Create a Policy entry • Eclipse Ditto • a digital twin framework</title>
+
+<link rel="stylesheet" href="css/syntax.css">
+<link rel="stylesheet" type="text/css" href="//cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/modern-business.css">
+<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/customstyles.css">
+<link rel="stylesheet" href="css/boxshadowproperties.css">
+<link rel="stylesheet" href="css/theme-ditto.css">
+<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:400,700|Source+Code+Pro:300,600|Titillium+Web:400,600,700">
+
+<script src="//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.4/jquery.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/js/bootstrap.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/anchor-js/2.0.0/anchor.min.js" crossorigin="anonymous"></script>
+<script src="js/toc.js"></script>
+<script src="js/customscripts.js"></script>
+
+<script type="application/ld+json">
+{
+ "@context": "http://schema.org",
+ "@type": "Organization",
+ "url": "https://eclipse.org/ditto/",
+ "logo": "https://eclipse.org/ditto/images/ditto.svg"
+}
+</script>
+
+<link rel="icon" type="image/png" href="images/favicon-16x16.png" sizes="16x16">
+<link rel="icon" type="image/png" href="images/favicon-32x32.png" sizes="32x32">
+<link rel="icon" type="image/png" href="images/favicon-96x96.png" sizes="96x96">
+
+<link rel="alternate" type="application/rss+xml" title="Eclipse Ditto Blog" href="https://www.eclipse.org/ditto/feed.xml">
+
+<!-- Eclipse Foundation cookie consent: -->
+<link rel="stylesheet" type="text/css" href="//www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css" />
+<script src="//www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+ <script>
+ $(document).ready(function() {
+ $("#tg-sb-link").click(function() {
+ $("#tg-sb-sidebar").toggle();
+ $("#tg-sb-content").toggleClass('col-md-9');
+ $("#tg-sb-content").toggleClass('col-md-12');
+ $("#tg-sb-icon").toggleClass('fa-toggle-on');
+ $("#tg-sb-icon").toggleClass('fa-toggle-off');
+ });
+ });
+ </script>
+</head>
+
+
+<script>
+ (function(w,d,s,l,i){
+ w[l]=w[l]||[];
+ w[l].push({'gtm.start':
+ new Date().getTime(),event:'gtm.js'});
+ var f=d.getElementsByTagName(s)[0],
+ j=d.createElement(s),
+ dl=l!='dataLayer'?'&l='+l:'';
+ j.async=true;
+ j.src='https://www.googletagmanager.com/gtm.js?id='+i+dl;
+ f.parentNode.insertBefore(j,f);
+ })(window,document,'script','dataLayer','GTM-5WLCZXC');
+</script>
+
+
+
+<body>
+<!-- Navigation -->
+<nav class="navbar navbar-inverse navbar-fixed-top">
+ <div class="container topnavlinks">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-ditto-home" href="index.html"> <img src="images/ditto_allwhite_symbolonly.svg" class="ditto-navbar-symbol" alt="Home"> <img src="images/ditto_allwhite_textonly.svg" class="ditto-navbar-symbol-text" alt="Ditto"></a>
+ </div>
+ <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
+ <ul class="nav navbar-nav navbar-right">
+ <!-- toggle sidebar button -->
+ <!--<li><a id="tg-sb-link" href="#"><i id="tg-sb-icon" class="fa fa-toggle-on"></i> Nav</a></li>-->
+ <!-- entries without drop-downs appear here -->
+
+
+
+
+
+
+
+ <li><a href="blog.html">Blog</a></li>
+
+
+
+ <li><a href="intro-overview.html">Documentation</a></li>
+
+
+
+ <li><a href="http-api-doc.html">HTTP API</a></li>
+
+
+
+ <li><a href="https://ditto.eclipse.org" target="_blank">Sandbox</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">GitHub</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">GitHub examples</a></li>
+
+
+
+ <!-- entries with drop-downs appear here -->
+ <!-- conditional logic to control which topnav appears for the audience defined in the configuration file.-->
+
+
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Links<b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+
+ <li><a href="https://projects.eclipse.org/projects/iot.ditto" target="_blank">Eclipse Ditto Project</a></li>
+
+
+
+ <li><a href="https://www.eclipse.org/forums/index.php/f/364/" target="_blank">Forum</a></li>
+
+
+
+ <li><a href="https://ci.eclipse.org/ditto/" target="_blank">Jenkins</a></li>
+
+
+
+ <li><a href="https://dev.eclipse.org/mhonarc/lists/ditto-dev/" target="_blank">Mailing list archives</a></li>
+
+
+
+ <li><a href="https://gitter.im/eclipse/ditto" target="_blank">Gitter.im chat</a></li>
+
+
+ </ul>
+ </li>
+
+
+
+ <!--comment out this block if you want to hide search-->
+ <li>
+ <!--start search-->
+ <div id="search-demo-container">
+ <input type="text" id="search-input" placeholder="search...">
+ <ul id="results-container"></ul>
+ </div>
+ <script src="//cdnjs.cloudflare.com/ajax/libs/simple-jekyll-search/0.0.9/jekyll-search.js" type="text/javascript"></script>
+ <script type="text/javascript">
+ SimpleJekyllSearch.init({
+ searchInput: document.getElementById('search-input'),
+ resultsContainer: document.getElementById('results-container'),
+ dataSource: 'search.json',
+ searchResultTemplate: '<li><a href="{url}" title="Create a Policy entry">{title}</a></li>',
+ noResultsText: 'No results found.',
+ limit: 10,
+ fuzzy: true,
+ })
+ </script>
+ <!--end search-->
+ </li>
+ </ul>
+ </div>
+ </div>
+ <!-- /.container -->
+</nav>
+
+<!-- Page Content -->
+<div class="container">
+ <div id="main">
+ <!-- Content Row -->
+ <div class="row">
+
+
+ <!-- Sidebar Column -->
+ <div class="col-md-3" id="tg-sb-sidebar">
+
+
+<ul id="mysidebar" class="nav">
+ <li class="sidebarTitle">
+ <label for="docVersion">Eclipse Ditto version:</label>
+ <div class="select-wrapper">
+ <select id="docVersion" name="docVersion">
+
+ <option value="">development</option>
+
+ <option value="1.0">1.0</option>
+
+ <option value="1.1">1.1</option>
+
+ </select>
+ </div>
+ <div id="dev-warning">
+ <div markdown="span" class="alert alert-warning" role="alert" style="font-size:0.6em"><i class="fa fa-warning"></i> <b>Important:</b> This documentation reflects the latest 'development'. You might want to choose a released version.</div>
+ </div>
+ </li>
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Introduction</a>
+ <ul>
+
+
+
+ <li><a href="intro-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="intro-digitaltwins.html">Digital twins</a></li>
+
+
+
+
+
+
+ <li><a href="intro-hello-world.html">Hello world</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Release Notes</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_100.html">1.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_090.html">0.9.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_080.html">0.8.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Milestone releases</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_100-M2.html">1.0.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_100-M1a.html">1.0.0-M1a</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M2.html">0.9.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M1.html">0.9.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M3.html">0.8.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M2.html">0.8.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M1.html">0.8.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M2.html">0.3.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M1.html">0.3.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_020-M1.html">0.2.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M3.html">0.1.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M1.html">0.1.0-M1</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Installation</a>
+ <ul>
+
+
+
+ <li><a href="installation-building.html">Building Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-running.html">Running Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-operating.html">Operating Ditto</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Basic concepts</a>
+ <ul>
+
+
+
+ <li><a href="basic-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Model entities</a>
+ <ul>
+
+
+
+ <li><a href="basic-thing.html">Thing</a></li>
+
+
+
+
+
+ <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
+
+
+
+
+
+ <li><a href="basic-feature.html">Feature</a></li>
+
+
+
+
+
+ <li><a href="basic-policy.html">Policy</a></li>
+
+
+
+
+
+ <li><a href="basic-namespaces-and-names.html">Namespaces and Names</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-auth.html">Authentication and Authorization</a></li>
+
+
+
+
+
+
+ <li><a href="basic-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="basic-signals.html">Signals</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Signal types</a>
+ <ul>
+
+
+
+ <li><a href="basic-signals-command.html">Command</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-commandresponse.html">Command response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-errorresponse.html">Error response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-event.html">Event</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-apis.html">APIs</a></li>
+
+
+
+
+
+
+ <li><a href="basic-connections.html">Connections</a></li>
+
+
+
+
+
+
+ <li><a href="basic-placeholders.html">Placeholders</a></li>
+
+
+
+
+
+
+ <li><a href="basic-changenotifications.html">Change notifications</a></li>
+
+
+
+
+
+
+ <li><a href="basic-rql.html">RQL expressions</a></li>
+
+
+
+
+
+
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
+ <li><a href="basic-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Architecture</a>
+ <ul>
+
+
+
+ <li><a href="architecture-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Services</a>
+ <ul>
+
+
+
+ <li><a href="architecture-services-policies.html">Policies</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things.html">Things</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things-search.html">Things-Search</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-connectivity.html">Connectivity</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-concierge.html">Concierge</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-gateway.html">Gateway</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>HTTP API</a>
+ <ul>
+
+
+
+ <li><a href="httpapi-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-concepts.html">Concepts</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-protocol-bindings-websocket.html">WebSocket protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-sse.html">Server sent events</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Connectivity API</a>
+ <ul>
+
+
+
+ <li><a href="connectivity-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-manage-connections.html">Manage connections</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp091.html">AMQP 0.9.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp10.html">AMQP 1.0 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-kafka2.html">Kafka 2.x protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-mapping.html">Payload mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-header-mapping.html">Header mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-tls-certificates.html">TLS certificates</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Client SDK</a>
+ <ul>
+
+
+
+ <li><a href="client-sdk-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-java.html">Java</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-javascript.html">JavaScript</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Ditto Protocol</a>
+ <ul>
+
+
+
+ <li><a href="protocol-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-twinlive.html">Twin/live channel</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification.html">Specification</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-topic.html">Protocol topic</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-things.html">Things group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-delete.html">Delete</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ search/messages</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-search.html">Search</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-messages.html">Messages</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-bindings.html">Bindings</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-examples.html">Examples</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-creatething.html">Create a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletething.html">Delete a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifything.html">Modify a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievething.html">Retrieve a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethings.html">Retrieve multiple Things</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattributes.html">Delete Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattributes.html">Modify Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattributes.html">Retrieve Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattribute.html">Create a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattribute.html">Delete a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattribute.html">Modify a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattribute.html">Retrieve a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createthingdefinition.html">Create a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletethingdefinition.html">Delete a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifythingdefinition.html">Modify a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethingdefinition.html">Retrieve a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeatures.html">Create Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeatures.html">Delete Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeatures.html">Modify Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeatures.html">Retrieve Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeature.html">Create a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeature.html">Delete a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeature.html">Modify a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeature.html">Retrieve a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdefinition.html">Create Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedefinition.html">Delete Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydefinition.html">Modify Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedefinition.html">Retrieve Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperties.html">Create Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperties.html">Delete Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperties.html">Modify Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperties.html">Retrieve Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperty.html">Create a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperty.html">Delete a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperty.html">Modify a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperty.html">Retrieve a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li class="active"><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li><a href="sandbox.html">Sandbox</a></li>
+
+
+
+
+
+ <li><a href="presentations.html">Presentations</a></li>
+
+
+
+
+
+ <li><a href="glossary.html">Glossary</a></li>
+
+
+
+
+
+ <li><a href="feedback.html">Feedback</a></li>
+
+
+
+
+
+ <p class="external">
+ <a href="#" id="collapseAll">Collapse All</a> | <a href="#" id="expandAll">Expand All</a>
+ </p>
+
+</ul>
+
+<!-- this highlights the active parent class in the sidebar. this is critical so that the parent expands when you're viewing a page. This must appear below the sidebar code above. Otherwise, if placed inside customscripts.js, the script runs before the sidebar code runs and the class never gets inserted.-->
+<script>$("li.active").parents('li').toggleClass("active");
+
+$(function() {
+ $("#dev-warning").hide();
+ changeSelectedDocVersionDropdownSelection($("#docVersion")[0]);
+ $("#docVersion").change(changeSelectedDocVersion);
+});
+
+function changeSelectedDocVersionDropdownSelection(element) {
+ var pathName = window.location.pathname;
+
+ var versionOptions = element.options;
+ for (var i = 0; i < versionOptions.length; i++) {
+ var versionValue = versionOptions[i].value;
+ if ((versionValue !== "") && pathName.startsWith("/ditto/"+versionValue+"/")) {
+ $("#docVersion").val(versionValue).change();
+ return;
+ }
+ }
+ // fallback: dev with "empty" version value:
+ $("#docVersion").val("").change();
+ $("#dev-warning").show();
+}
+function changeSelectedDocVersion() {
+ var versionValue = $('#docVersion').val();
+ var remainingPath = window.location.pathname.replace("/ditto/", "");
+ var versionMatch = remainingPath.match("([0-9].[0.9])/(.*)");
+ if (versionValue === "" && !versionMatch) {
+ // do nothing, we're already on the correct "dev" version
+ } else if (versionMatch && (versionValue === versionMatch[1])) {
+ // do nothing, we're already on the correct version
+ } else {
+ if (versionValue === "" && versionMatch) {
+ window.location.pathname = "ditto/" + versionMatch[2];
+ } else if (versionValue === "") {
+ window.location.pathname = "ditto/" + remainingPath;
+ } else if (versionMatch) {
+ window.location.pathname = "ditto/" + versionValue + "/" + versionMatch[2];
+ } else {
+ window.location.pathname = "ditto/" + versionValue + "/" + remainingPath;
+ }
+ }
+}
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Create a Policy entry</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+
+
+
+<!-- this handles the automatic toc. use ## for subheads to auto-generate the on-page minitoc. if you use html tags, you must supply an ID for the heading element in order for it to appear in the minitoc. -->
+<script>
+$( document ).ready(function() {
+ // Handler for .ready() called.
+
+$('#toc').toc({ minimumHeaders: 0, listType: 'ul', showSpeed: 0, headers: 'h2,h3,h4' });
+
+/* this offset helps account for the space taken up by the floating toolbar. */
+$('#toc').on('click', 'a', function() {
+ var target = $(this.getAttribute('href'))
+ , scroll_target = target.offset().top
+
+ $(window).scrollTop(scroll_target - 10);
+ return false
+})
+
+});
+</script>
+
+<div id="toc"></div>
+
+
+
+
+
+
+
+
+
+
+<h2 id="modifypolicyentry">ModifyPolicyEntry</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/the_policy_id/policies/commands/modify"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/entries/the_label"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"subjects"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"google:the_subjectid"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"__schemaVersion"</span><span class="p">:</span><span class="w"> </span><span class="mi">2</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"yourSubjectTypeDescription"</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"resources"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"thing:/the_resource_path"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"__schemaVersion"</span><span class="p">:</span><span class="w"> </span><span class="mi">2</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"grant"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
+ </span><span class="s2">"READ"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"WRITE"</span><span class="w">
+ </span><span class="p">],</span><span class="w">
+ </span><span class="s2">"revoke"</span><span class="p">:</span><span class="w"> </span><span class="p">[]</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="modifypolicyentryresponse">ModifyPolicyEntryResponse</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/the_policy_id/policies/commands/modify"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/entries/the_label"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">204</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+
+
+ <div class="tags">
+
+ </div>
+
+</div>
+
+<hr class="shaded"/>
+
+<footer>
+ <div class="row">
+ <div class="col-lg-12 footer">
+ <div class="logo">
+ <a href="https://eclipse.org"><img src="images/eclipse_foundation_logo.svg" alt="Eclipse logo"/></a>
+ </div>
+ <p class="notice">
+ ©2020 Eclipse Ditto.
+ Site last generated: Jul 1, 2020 <br />
+ </p>
+ <div class="quickLinks">
+ <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
+ > Privacy Policy
+ </a>
+ <a href="https://www.eclipse.org/legal/termsofuse.php" target="_blank">
+ > Terms of Use
+ </a>
+ <a href="https://www.eclipse.org/legal/copyright.php" target="_blank">
+ > Copyright Agent
+ </a>
+ <a href="https://www.eclipse.org/legal" target="_blank">
+ > Legal
+ </a>
+ <a href="https://www.eclipse.org/legal/epl-2.0/" target="_blank">
+ > License
+ </a>
+ <a href="https://eclipse.org/security" target="_blank">
+ > Report a Vulnerability
+ </a>
+ </div>
+ </div>
+ </div>
+</footer>
+
+
+ </div>
+ <!-- /.row -->
+</div>
+<!-- /.container -->
+</div>
+<!-- /#main -->
+ </div>
+
+</body>
+</html>
diff --git a/1.0/protocol-examples-policies-createresource.html b/1.0/protocol-examples-policies-createresource.html
new file mode 100644
index 0000000..5e1950e
--- /dev/null
+++ b/1.0/protocol-examples-policies-createresource.html
@@ -0,0 +1,1557 @@
+<!DOCTYPE html>
+<html>
+<head>
+ <meta charset="utf-8">
+<meta http-equiv="X-UA-Compatible" content="IE=edge">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="description" content="">
+<meta name="keywords" content=" examples, create resource">
+<title> Create a resource • Eclipse Ditto • a digital twin framework</title>
+
+<link rel="stylesheet" href="css/syntax.css">
+<link rel="stylesheet" type="text/css" href="//cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/modern-business.css">
+<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/customstyles.css">
+<link rel="stylesheet" href="css/boxshadowproperties.css">
+<link rel="stylesheet" href="css/theme-ditto.css">
+<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:400,700|Source+Code+Pro:300,600|Titillium+Web:400,600,700">
+
+<script src="//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.4/jquery.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/js/bootstrap.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/anchor-js/2.0.0/anchor.min.js" crossorigin="anonymous"></script>
+<script src="js/toc.js"></script>
+<script src="js/customscripts.js"></script>
+
+<script type="application/ld+json">
+{
+ "@context": "http://schema.org",
+ "@type": "Organization",
+ "url": "https://eclipse.org/ditto/",
+ "logo": "https://eclipse.org/ditto/images/ditto.svg"
+}
+</script>
+
+<link rel="icon" type="image/png" href="images/favicon-16x16.png" sizes="16x16">
+<link rel="icon" type="image/png" href="images/favicon-32x32.png" sizes="32x32">
+<link rel="icon" type="image/png" href="images/favicon-96x96.png" sizes="96x96">
+
+<link rel="alternate" type="application/rss+xml" title="Eclipse Ditto Blog" href="https://www.eclipse.org/ditto/feed.xml">
+
+<!-- Eclipse Foundation cookie consent: -->
+<link rel="stylesheet" type="text/css" href="//www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css" />
+<script src="//www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+ <script>
+ $(document).ready(function() {
+ $("#tg-sb-link").click(function() {
+ $("#tg-sb-sidebar").toggle();
+ $("#tg-sb-content").toggleClass('col-md-9');
+ $("#tg-sb-content").toggleClass('col-md-12');
+ $("#tg-sb-icon").toggleClass('fa-toggle-on');
+ $("#tg-sb-icon").toggleClass('fa-toggle-off');
+ });
+ });
+ </script>
+</head>
+
+
+<script>
+ (function(w,d,s,l,i){
+ w[l]=w[l]||[];
+ w[l].push({'gtm.start':
+ new Date().getTime(),event:'gtm.js'});
+ var f=d.getElementsByTagName(s)[0],
+ j=d.createElement(s),
+ dl=l!='dataLayer'?'&l='+l:'';
+ j.async=true;
+ j.src='https://www.googletagmanager.com/gtm.js?id='+i+dl;
+ f.parentNode.insertBefore(j,f);
+ })(window,document,'script','dataLayer','GTM-5WLCZXC');
+</script>
+
+
+
+<body>
+<!-- Navigation -->
+<nav class="navbar navbar-inverse navbar-fixed-top">
+ <div class="container topnavlinks">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-ditto-home" href="index.html"> <img src="images/ditto_allwhite_symbolonly.svg" class="ditto-navbar-symbol" alt="Home"> <img src="images/ditto_allwhite_textonly.svg" class="ditto-navbar-symbol-text" alt="Ditto"></a>
+ </div>
+ <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
+ <ul class="nav navbar-nav navbar-right">
+ <!-- toggle sidebar button -->
+ <!--<li><a id="tg-sb-link" href="#"><i id="tg-sb-icon" class="fa fa-toggle-on"></i> Nav</a></li>-->
+ <!-- entries without drop-downs appear here -->
+
+
+
+
+
+
+
+ <li><a href="blog.html">Blog</a></li>
+
+
+
+ <li><a href="intro-overview.html">Documentation</a></li>
+
+
+
+ <li><a href="http-api-doc.html">HTTP API</a></li>
+
+
+
+ <li><a href="https://ditto.eclipse.org" target="_blank">Sandbox</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">GitHub</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">GitHub examples</a></li>
+
+
+
+ <!-- entries with drop-downs appear here -->
+ <!-- conditional logic to control which topnav appears for the audience defined in the configuration file.-->
+
+
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Links<b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+
+ <li><a href="https://projects.eclipse.org/projects/iot.ditto" target="_blank">Eclipse Ditto Project</a></li>
+
+
+
+ <li><a href="https://www.eclipse.org/forums/index.php/f/364/" target="_blank">Forum</a></li>
+
+
+
+ <li><a href="https://ci.eclipse.org/ditto/" target="_blank">Jenkins</a></li>
+
+
+
+ <li><a href="https://dev.eclipse.org/mhonarc/lists/ditto-dev/" target="_blank">Mailing list archives</a></li>
+
+
+
+ <li><a href="https://gitter.im/eclipse/ditto" target="_blank">Gitter.im chat</a></li>
+
+
+ </ul>
+ </li>
+
+
+
+ <!--comment out this block if you want to hide search-->
+ <li>
+ <!--start search-->
+ <div id="search-demo-container">
+ <input type="text" id="search-input" placeholder="search...">
+ <ul id="results-container"></ul>
+ </div>
+ <script src="//cdnjs.cloudflare.com/ajax/libs/simple-jekyll-search/0.0.9/jekyll-search.js" type="text/javascript"></script>
+ <script type="text/javascript">
+ SimpleJekyllSearch.init({
+ searchInput: document.getElementById('search-input'),
+ resultsContainer: document.getElementById('results-container'),
+ dataSource: 'search.json',
+ searchResultTemplate: '<li><a href="{url}" title="Create a resource">{title}</a></li>',
+ noResultsText: 'No results found.',
+ limit: 10,
+ fuzzy: true,
+ })
+ </script>
+ <!--end search-->
+ </li>
+ </ul>
+ </div>
+ </div>
+ <!-- /.container -->
+</nav>
+
+<!-- Page Content -->
+<div class="container">
+ <div id="main">
+ <!-- Content Row -->
+ <div class="row">
+
+
+ <!-- Sidebar Column -->
+ <div class="col-md-3" id="tg-sb-sidebar">
+
+
+<ul id="mysidebar" class="nav">
+ <li class="sidebarTitle">
+ <label for="docVersion">Eclipse Ditto version:</label>
+ <div class="select-wrapper">
+ <select id="docVersion" name="docVersion">
+
+ <option value="">development</option>
+
+ <option value="1.0">1.0</option>
+
+ <option value="1.1">1.1</option>
+
+ </select>
+ </div>
+ <div id="dev-warning">
+ <div markdown="span" class="alert alert-warning" role="alert" style="font-size:0.6em"><i class="fa fa-warning"></i> <b>Important:</b> This documentation reflects the latest 'development'. You might want to choose a released version.</div>
+ </div>
+ </li>
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Introduction</a>
+ <ul>
+
+
+
+ <li><a href="intro-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="intro-digitaltwins.html">Digital twins</a></li>
+
+
+
+
+
+
+ <li><a href="intro-hello-world.html">Hello world</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Release Notes</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_100.html">1.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_090.html">0.9.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_080.html">0.8.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Milestone releases</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_100-M2.html">1.0.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_100-M1a.html">1.0.0-M1a</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M2.html">0.9.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M1.html">0.9.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M3.html">0.8.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M2.html">0.8.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M1.html">0.8.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M2.html">0.3.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M1.html">0.3.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_020-M1.html">0.2.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M3.html">0.1.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M1.html">0.1.0-M1</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Installation</a>
+ <ul>
+
+
+
+ <li><a href="installation-building.html">Building Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-running.html">Running Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-operating.html">Operating Ditto</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Basic concepts</a>
+ <ul>
+
+
+
+ <li><a href="basic-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Model entities</a>
+ <ul>
+
+
+
+ <li><a href="basic-thing.html">Thing</a></li>
+
+
+
+
+
+ <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
+
+
+
+
+
+ <li><a href="basic-feature.html">Feature</a></li>
+
+
+
+
+
+ <li><a href="basic-policy.html">Policy</a></li>
+
+
+
+
+
+ <li><a href="basic-namespaces-and-names.html">Namespaces and Names</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-auth.html">Authentication and Authorization</a></li>
+
+
+
+
+
+
+ <li><a href="basic-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="basic-signals.html">Signals</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Signal types</a>
+ <ul>
+
+
+
+ <li><a href="basic-signals-command.html">Command</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-commandresponse.html">Command response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-errorresponse.html">Error response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-event.html">Event</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-apis.html">APIs</a></li>
+
+
+
+
+
+
+ <li><a href="basic-connections.html">Connections</a></li>
+
+
+
+
+
+
+ <li><a href="basic-placeholders.html">Placeholders</a></li>
+
+
+
+
+
+
+ <li><a href="basic-changenotifications.html">Change notifications</a></li>
+
+
+
+
+
+
+ <li><a href="basic-rql.html">RQL expressions</a></li>
+
+
+
+
+
+
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
+ <li><a href="basic-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Architecture</a>
+ <ul>
+
+
+
+ <li><a href="architecture-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Services</a>
+ <ul>
+
+
+
+ <li><a href="architecture-services-policies.html">Policies</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things.html">Things</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things-search.html">Things-Search</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-connectivity.html">Connectivity</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-concierge.html">Concierge</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-gateway.html">Gateway</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>HTTP API</a>
+ <ul>
+
+
+
+ <li><a href="httpapi-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-concepts.html">Concepts</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-protocol-bindings-websocket.html">WebSocket protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-sse.html">Server sent events</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Connectivity API</a>
+ <ul>
+
+
+
+ <li><a href="connectivity-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-manage-connections.html">Manage connections</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp091.html">AMQP 0.9.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp10.html">AMQP 1.0 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-kafka2.html">Kafka 2.x protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-mapping.html">Payload mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-header-mapping.html">Header mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-tls-certificates.html">TLS certificates</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Client SDK</a>
+ <ul>
+
+
+
+ <li><a href="client-sdk-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-java.html">Java</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-javascript.html">JavaScript</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Ditto Protocol</a>
+ <ul>
+
+
+
+ <li><a href="protocol-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-twinlive.html">Twin/live channel</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification.html">Specification</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-topic.html">Protocol topic</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-things.html">Things group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-delete.html">Delete</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ search/messages</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-search.html">Search</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-messages.html">Messages</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-bindings.html">Bindings</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-examples.html">Examples</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-creatething.html">Create a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletething.html">Delete a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifything.html">Modify a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievething.html">Retrieve a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethings.html">Retrieve multiple Things</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattributes.html">Delete Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattributes.html">Modify Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattributes.html">Retrieve Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattribute.html">Create a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattribute.html">Delete a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattribute.html">Modify a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattribute.html">Retrieve a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createthingdefinition.html">Create a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletethingdefinition.html">Delete a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifythingdefinition.html">Modify a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethingdefinition.html">Retrieve a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeatures.html">Create Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeatures.html">Delete Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeatures.html">Modify Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeatures.html">Retrieve Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeature.html">Create a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeature.html">Delete a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeature.html">Modify a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeature.html">Retrieve a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdefinition.html">Create Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedefinition.html">Delete Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydefinition.html">Modify Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedefinition.html">Retrieve Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperties.html">Create Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperties.html">Delete Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperties.html">Modify Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperties.html">Retrieve Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperty.html">Create a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperty.html">Delete a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperty.html">Modify a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperty.html">Retrieve a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li class="active"><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li><a href="sandbox.html">Sandbox</a></li>
+
+
+
+
+
+ <li><a href="presentations.html">Presentations</a></li>
+
+
+
+
+
+ <li><a href="glossary.html">Glossary</a></li>
+
+
+
+
+
+ <li><a href="feedback.html">Feedback</a></li>
+
+
+
+
+
+ <p class="external">
+ <a href="#" id="collapseAll">Collapse All</a> | <a href="#" id="expandAll">Expand All</a>
+ </p>
+
+</ul>
+
+<!-- this highlights the active parent class in the sidebar. this is critical so that the parent expands when you're viewing a page. This must appear below the sidebar code above. Otherwise, if placed inside customscripts.js, the script runs before the sidebar code runs and the class never gets inserted.-->
+<script>$("li.active").parents('li').toggleClass("active");
+
+$(function() {
+ $("#dev-warning").hide();
+ changeSelectedDocVersionDropdownSelection($("#docVersion")[0]);
+ $("#docVersion").change(changeSelectedDocVersion);
+});
+
+function changeSelectedDocVersionDropdownSelection(element) {
+ var pathName = window.location.pathname;
+
+ var versionOptions = element.options;
+ for (var i = 0; i < versionOptions.length; i++) {
+ var versionValue = versionOptions[i].value;
+ if ((versionValue !== "") && pathName.startsWith("/ditto/"+versionValue+"/")) {
+ $("#docVersion").val(versionValue).change();
+ return;
+ }
+ }
+ // fallback: dev with "empty" version value:
+ $("#docVersion").val("").change();
+ $("#dev-warning").show();
+}
+function changeSelectedDocVersion() {
+ var versionValue = $('#docVersion').val();
+ var remainingPath = window.location.pathname.replace("/ditto/", "");
+ var versionMatch = remainingPath.match("([0-9].[0.9])/(.*)");
+ if (versionValue === "" && !versionMatch) {
+ // do nothing, we're already on the correct "dev" version
+ } else if (versionMatch && (versionValue === versionMatch[1])) {
+ // do nothing, we're already on the correct version
+ } else {
+ if (versionValue === "" && versionMatch) {
+ window.location.pathname = "ditto/" + versionMatch[2];
+ } else if (versionValue === "") {
+ window.location.pathname = "ditto/" + remainingPath;
+ } else if (versionMatch) {
+ window.location.pathname = "ditto/" + versionValue + "/" + versionMatch[2];
+ } else {
+ window.location.pathname = "ditto/" + versionValue + "/" + remainingPath;
+ }
+ }
+}
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Create a resource</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+
+
+
+<!-- this handles the automatic toc. use ## for subheads to auto-generate the on-page minitoc. if you use html tags, you must supply an ID for the heading element in order for it to appear in the minitoc. -->
+<script>
+$( document ).ready(function() {
+ // Handler for .ready() called.
+
+$('#toc').toc({ minimumHeaders: 0, listType: 'ul', showSpeed: 0, headers: 'h2,h3,h4' });
+
+/* this offset helps account for the space taken up by the floating toolbar. */
+$('#toc').on('click', 'a', function() {
+ var target = $(this.getAttribute('href'))
+ , scroll_target = target.offset().top
+
+ $(window).scrollTop(scroll_target - 10);
+ return false
+})
+
+});
+</script>
+
+<div id="toc"></div>
+
+
+
+
+
+
+
+
+
+
+<h2 id="modifyresource">ModifyResource</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/the_policy_id/policies/commands/modify"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/entries/the_label/resources/thing:/the_resource_path"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"grant"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
+ </span><span class="s2">"READ"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"WRITE"</span><span class="w">
+ </span><span class="p">],</span><span class="w">
+ </span><span class="s2">"revoke"</span><span class="p">:</span><span class="w"> </span><span class="p">[]</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="modifyresourceresponse">ModifyResourceResponse</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/the_policy_id/policies/commands/modify"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/entries/the_label/resources/thing:/the_resource_path"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">204</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+
+
+ <div class="tags">
+
+ </div>
+
+</div>
+
+<hr class="shaded"/>
+
+<footer>
+ <div class="row">
+ <div class="col-lg-12 footer">
+ <div class="logo">
+ <a href="https://eclipse.org"><img src="images/eclipse_foundation_logo.svg" alt="Eclipse logo"/></a>
+ </div>
+ <p class="notice">
+ ©2020 Eclipse Ditto.
+ Site last generated: Jul 1, 2020 <br />
+ </p>
+ <div class="quickLinks">
+ <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
+ > Privacy Policy
+ </a>
+ <a href="https://www.eclipse.org/legal/termsofuse.php" target="_blank">
+ > Terms of Use
+ </a>
+ <a href="https://www.eclipse.org/legal/copyright.php" target="_blank">
+ > Copyright Agent
+ </a>
+ <a href="https://www.eclipse.org/legal" target="_blank">
+ > Legal
+ </a>
+ <a href="https://www.eclipse.org/legal/epl-2.0/" target="_blank">
+ > License
+ </a>
+ <a href="https://eclipse.org/security" target="_blank">
+ > Report a Vulnerability
+ </a>
+ </div>
+ </div>
+ </div>
+</footer>
+
+
+ </div>
+ <!-- /.row -->
+</div>
+<!-- /.container -->
+</div>
+<!-- /#main -->
+ </div>
+
+</body>
+</html>
diff --git a/1.0/protocol-examples-policies-createsubject.html b/1.0/protocol-examples-policies-createsubject.html
new file mode 100644
index 0000000..091a744
--- /dev/null
+++ b/1.0/protocol-examples-policies-createsubject.html
@@ -0,0 +1,1553 @@
+<!DOCTYPE html>
+<html>
+<head>
+ <meta charset="utf-8">
+<meta http-equiv="X-UA-Compatible" content="IE=edge">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="description" content="">
+<meta name="keywords" content=" examples, create subject">
+<title> Create a subject • Eclipse Ditto • a digital twin framework</title>
+
+<link rel="stylesheet" href="css/syntax.css">
+<link rel="stylesheet" type="text/css" href="//cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/modern-business.css">
+<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/customstyles.css">
+<link rel="stylesheet" href="css/boxshadowproperties.css">
+<link rel="stylesheet" href="css/theme-ditto.css">
+<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:400,700|Source+Code+Pro:300,600|Titillium+Web:400,600,700">
+
+<script src="//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.4/jquery.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/js/bootstrap.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/anchor-js/2.0.0/anchor.min.js" crossorigin="anonymous"></script>
+<script src="js/toc.js"></script>
+<script src="js/customscripts.js"></script>
+
+<script type="application/ld+json">
+{
+ "@context": "http://schema.org",
+ "@type": "Organization",
+ "url": "https://eclipse.org/ditto/",
+ "logo": "https://eclipse.org/ditto/images/ditto.svg"
+}
+</script>
+
+<link rel="icon" type="image/png" href="images/favicon-16x16.png" sizes="16x16">
+<link rel="icon" type="image/png" href="images/favicon-32x32.png" sizes="32x32">
+<link rel="icon" type="image/png" href="images/favicon-96x96.png" sizes="96x96">
+
+<link rel="alternate" type="application/rss+xml" title="Eclipse Ditto Blog" href="https://www.eclipse.org/ditto/feed.xml">
+
+<!-- Eclipse Foundation cookie consent: -->
+<link rel="stylesheet" type="text/css" href="//www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css" />
+<script src="//www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+ <script>
+ $(document).ready(function() {
+ $("#tg-sb-link").click(function() {
+ $("#tg-sb-sidebar").toggle();
+ $("#tg-sb-content").toggleClass('col-md-9');
+ $("#tg-sb-content").toggleClass('col-md-12');
+ $("#tg-sb-icon").toggleClass('fa-toggle-on');
+ $("#tg-sb-icon").toggleClass('fa-toggle-off');
+ });
+ });
+ </script>
+</head>
+
+
+<script>
+ (function(w,d,s,l,i){
+ w[l]=w[l]||[];
+ w[l].push({'gtm.start':
+ new Date().getTime(),event:'gtm.js'});
+ var f=d.getElementsByTagName(s)[0],
+ j=d.createElement(s),
+ dl=l!='dataLayer'?'&l='+l:'';
+ j.async=true;
+ j.src='https://www.googletagmanager.com/gtm.js?id='+i+dl;
+ f.parentNode.insertBefore(j,f);
+ })(window,document,'script','dataLayer','GTM-5WLCZXC');
+</script>
+
+
+
+<body>
+<!-- Navigation -->
+<nav class="navbar navbar-inverse navbar-fixed-top">
+ <div class="container topnavlinks">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-ditto-home" href="index.html"> <img src="images/ditto_allwhite_symbolonly.svg" class="ditto-navbar-symbol" alt="Home"> <img src="images/ditto_allwhite_textonly.svg" class="ditto-navbar-symbol-text" alt="Ditto"></a>
+ </div>
+ <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
+ <ul class="nav navbar-nav navbar-right">
+ <!-- toggle sidebar button -->
+ <!--<li><a id="tg-sb-link" href="#"><i id="tg-sb-icon" class="fa fa-toggle-on"></i> Nav</a></li>-->
+ <!-- entries without drop-downs appear here -->
+
+
+
+
+
+
+
+ <li><a href="blog.html">Blog</a></li>
+
+
+
+ <li><a href="intro-overview.html">Documentation</a></li>
+
+
+
+ <li><a href="http-api-doc.html">HTTP API</a></li>
+
+
+
+ <li><a href="https://ditto.eclipse.org" target="_blank">Sandbox</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">GitHub</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">GitHub examples</a></li>
+
+
+
+ <!-- entries with drop-downs appear here -->
+ <!-- conditional logic to control which topnav appears for the audience defined in the configuration file.-->
+
+
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Links<b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+
+ <li><a href="https://projects.eclipse.org/projects/iot.ditto" target="_blank">Eclipse Ditto Project</a></li>
+
+
+
+ <li><a href="https://www.eclipse.org/forums/index.php/f/364/" target="_blank">Forum</a></li>
+
+
+
+ <li><a href="https://ci.eclipse.org/ditto/" target="_blank">Jenkins</a></li>
+
+
+
+ <li><a href="https://dev.eclipse.org/mhonarc/lists/ditto-dev/" target="_blank">Mailing list archives</a></li>
+
+
+
+ <li><a href="https://gitter.im/eclipse/ditto" target="_blank">Gitter.im chat</a></li>
+
+
+ </ul>
+ </li>
+
+
+
+ <!--comment out this block if you want to hide search-->
+ <li>
+ <!--start search-->
+ <div id="search-demo-container">
+ <input type="text" id="search-input" placeholder="search...">
+ <ul id="results-container"></ul>
+ </div>
+ <script src="//cdnjs.cloudflare.com/ajax/libs/simple-jekyll-search/0.0.9/jekyll-search.js" type="text/javascript"></script>
+ <script type="text/javascript">
+ SimpleJekyllSearch.init({
+ searchInput: document.getElementById('search-input'),
+ resultsContainer: document.getElementById('results-container'),
+ dataSource: 'search.json',
+ searchResultTemplate: '<li><a href="{url}" title="Create a subject">{title}</a></li>',
+ noResultsText: 'No results found.',
+ limit: 10,
+ fuzzy: true,
+ })
+ </script>
+ <!--end search-->
+ </li>
+ </ul>
+ </div>
+ </div>
+ <!-- /.container -->
+</nav>
+
+<!-- Page Content -->
+<div class="container">
+ <div id="main">
+ <!-- Content Row -->
+ <div class="row">
+
+
+ <!-- Sidebar Column -->
+ <div class="col-md-3" id="tg-sb-sidebar">
+
+
+<ul id="mysidebar" class="nav">
+ <li class="sidebarTitle">
+ <label for="docVersion">Eclipse Ditto version:</label>
+ <div class="select-wrapper">
+ <select id="docVersion" name="docVersion">
+
+ <option value="">development</option>
+
+ <option value="1.0">1.0</option>
+
+ <option value="1.1">1.1</option>
+
+ </select>
+ </div>
+ <div id="dev-warning">
+ <div markdown="span" class="alert alert-warning" role="alert" style="font-size:0.6em"><i class="fa fa-warning"></i> <b>Important:</b> This documentation reflects the latest 'development'. You might want to choose a released version.</div>
+ </div>
+ </li>
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Introduction</a>
+ <ul>
+
+
+
+ <li><a href="intro-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="intro-digitaltwins.html">Digital twins</a></li>
+
+
+
+
+
+
+ <li><a href="intro-hello-world.html">Hello world</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Release Notes</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_100.html">1.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_090.html">0.9.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_080.html">0.8.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Milestone releases</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_100-M2.html">1.0.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_100-M1a.html">1.0.0-M1a</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M2.html">0.9.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M1.html">0.9.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M3.html">0.8.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M2.html">0.8.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M1.html">0.8.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M2.html">0.3.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M1.html">0.3.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_020-M1.html">0.2.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M3.html">0.1.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M1.html">0.1.0-M1</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Installation</a>
+ <ul>
+
+
+
+ <li><a href="installation-building.html">Building Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-running.html">Running Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-operating.html">Operating Ditto</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Basic concepts</a>
+ <ul>
+
+
+
+ <li><a href="basic-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Model entities</a>
+ <ul>
+
+
+
+ <li><a href="basic-thing.html">Thing</a></li>
+
+
+
+
+
+ <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
+
+
+
+
+
+ <li><a href="basic-feature.html">Feature</a></li>
+
+
+
+
+
+ <li><a href="basic-policy.html">Policy</a></li>
+
+
+
+
+
+ <li><a href="basic-namespaces-and-names.html">Namespaces and Names</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-auth.html">Authentication and Authorization</a></li>
+
+
+
+
+
+
+ <li><a href="basic-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="basic-signals.html">Signals</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Signal types</a>
+ <ul>
+
+
+
+ <li><a href="basic-signals-command.html">Command</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-commandresponse.html">Command response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-errorresponse.html">Error response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-event.html">Event</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-apis.html">APIs</a></li>
+
+
+
+
+
+
+ <li><a href="basic-connections.html">Connections</a></li>
+
+
+
+
+
+
+ <li><a href="basic-placeholders.html">Placeholders</a></li>
+
+
+
+
+
+
+ <li><a href="basic-changenotifications.html">Change notifications</a></li>
+
+
+
+
+
+
+ <li><a href="basic-rql.html">RQL expressions</a></li>
+
+
+
+
+
+
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
+ <li><a href="basic-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Architecture</a>
+ <ul>
+
+
+
+ <li><a href="architecture-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Services</a>
+ <ul>
+
+
+
+ <li><a href="architecture-services-policies.html">Policies</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things.html">Things</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things-search.html">Things-Search</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-connectivity.html">Connectivity</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-concierge.html">Concierge</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-gateway.html">Gateway</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>HTTP API</a>
+ <ul>
+
+
+
+ <li><a href="httpapi-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-concepts.html">Concepts</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-protocol-bindings-websocket.html">WebSocket protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-sse.html">Server sent events</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Connectivity API</a>
+ <ul>
+
+
+
+ <li><a href="connectivity-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-manage-connections.html">Manage connections</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp091.html">AMQP 0.9.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp10.html">AMQP 1.0 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-kafka2.html">Kafka 2.x protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-mapping.html">Payload mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-header-mapping.html">Header mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-tls-certificates.html">TLS certificates</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Client SDK</a>
+ <ul>
+
+
+
+ <li><a href="client-sdk-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-java.html">Java</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-javascript.html">JavaScript</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Ditto Protocol</a>
+ <ul>
+
+
+
+ <li><a href="protocol-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-twinlive.html">Twin/live channel</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification.html">Specification</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-topic.html">Protocol topic</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-things.html">Things group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-delete.html">Delete</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ search/messages</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-search.html">Search</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-messages.html">Messages</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-bindings.html">Bindings</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-examples.html">Examples</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-creatething.html">Create a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletething.html">Delete a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifything.html">Modify a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievething.html">Retrieve a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethings.html">Retrieve multiple Things</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattributes.html">Delete Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattributes.html">Modify Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattributes.html">Retrieve Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattribute.html">Create a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattribute.html">Delete a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattribute.html">Modify a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattribute.html">Retrieve a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createthingdefinition.html">Create a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletethingdefinition.html">Delete a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifythingdefinition.html">Modify a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethingdefinition.html">Retrieve a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeatures.html">Create Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeatures.html">Delete Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeatures.html">Modify Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeatures.html">Retrieve Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeature.html">Create a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeature.html">Delete a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeature.html">Modify a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeature.html">Retrieve a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdefinition.html">Create Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedefinition.html">Delete Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydefinition.html">Modify Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedefinition.html">Retrieve Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperties.html">Create Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperties.html">Delete Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperties.html">Modify Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperties.html">Retrieve Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperty.html">Create a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperty.html">Delete a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperty.html">Modify a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperty.html">Retrieve a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li class="active"><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li><a href="sandbox.html">Sandbox</a></li>
+
+
+
+
+
+ <li><a href="presentations.html">Presentations</a></li>
+
+
+
+
+
+ <li><a href="glossary.html">Glossary</a></li>
+
+
+
+
+
+ <li><a href="feedback.html">Feedback</a></li>
+
+
+
+
+
+ <p class="external">
+ <a href="#" id="collapseAll">Collapse All</a> | <a href="#" id="expandAll">Expand All</a>
+ </p>
+
+</ul>
+
+<!-- this highlights the active parent class in the sidebar. this is critical so that the parent expands when you're viewing a page. This must appear below the sidebar code above. Otherwise, if placed inside customscripts.js, the script runs before the sidebar code runs and the class never gets inserted.-->
+<script>$("li.active").parents('li').toggleClass("active");
+
+$(function() {
+ $("#dev-warning").hide();
+ changeSelectedDocVersionDropdownSelection($("#docVersion")[0]);
+ $("#docVersion").change(changeSelectedDocVersion);
+});
+
+function changeSelectedDocVersionDropdownSelection(element) {
+ var pathName = window.location.pathname;
+
+ var versionOptions = element.options;
+ for (var i = 0; i < versionOptions.length; i++) {
+ var versionValue = versionOptions[i].value;
+ if ((versionValue !== "") && pathName.startsWith("/ditto/"+versionValue+"/")) {
+ $("#docVersion").val(versionValue).change();
+ return;
+ }
+ }
+ // fallback: dev with "empty" version value:
+ $("#docVersion").val("").change();
+ $("#dev-warning").show();
+}
+function changeSelectedDocVersion() {
+ var versionValue = $('#docVersion').val();
+ var remainingPath = window.location.pathname.replace("/ditto/", "");
+ var versionMatch = remainingPath.match("([0-9].[0.9])/(.*)");
+ if (versionValue === "" && !versionMatch) {
+ // do nothing, we're already on the correct "dev" version
+ } else if (versionMatch && (versionValue === versionMatch[1])) {
+ // do nothing, we're already on the correct version
+ } else {
+ if (versionValue === "" && versionMatch) {
+ window.location.pathname = "ditto/" + versionMatch[2];
+ } else if (versionValue === "") {
+ window.location.pathname = "ditto/" + remainingPath;
+ } else if (versionMatch) {
+ window.location.pathname = "ditto/" + versionValue + "/" + versionMatch[2];
+ } else {
+ window.location.pathname = "ditto/" + versionValue + "/" + remainingPath;
+ }
+ }
+}
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Create a subject</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+
+
+
+<!-- this handles the automatic toc. use ## for subheads to auto-generate the on-page minitoc. if you use html tags, you must supply an ID for the heading element in order for it to appear in the minitoc. -->
+<script>
+$( document ).ready(function() {
+ // Handler for .ready() called.
+
+$('#toc').toc({ minimumHeaders: 0, listType: 'ul', showSpeed: 0, headers: 'h2,h3,h4' });
+
+/* this offset helps account for the space taken up by the floating toolbar. */
+$('#toc').on('click', 'a', function() {
+ var target = $(this.getAttribute('href'))
+ , scroll_target = target.offset().top
+
+ $(window).scrollTop(scroll_target - 10);
+ return false
+})
+
+});
+</script>
+
+<div id="toc"></div>
+
+
+
+
+
+
+
+
+
+
+<h2 id="modifysubject">ModifySubject</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/the_policy_id/policies/commands/modify"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/entries/the_label/subjects/google:the_subjectid"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"yourSubjectTypeDescription"</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="modifysubjectresponse">ModifySubjectResponse</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/the_policy_id/policies/commands/modify"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/entries/the_label/subjects/google:the_subjectid"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">204</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+
+
+ <div class="tags">
+
+ </div>
+
+</div>
+
+<hr class="shaded"/>
+
+<footer>
+ <div class="row">
+ <div class="col-lg-12 footer">
+ <div class="logo">
+ <a href="https://eclipse.org"><img src="images/eclipse_foundation_logo.svg" alt="Eclipse logo"/></a>
+ </div>
+ <p class="notice">
+ ©2020 Eclipse Ditto.
+ Site last generated: Jul 1, 2020 <br />
+ </p>
+ <div class="quickLinks">
+ <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
+ > Privacy Policy
+ </a>
+ <a href="https://www.eclipse.org/legal/termsofuse.php" target="_blank">
+ > Terms of Use
+ </a>
+ <a href="https://www.eclipse.org/legal/copyright.php" target="_blank">
+ > Copyright Agent
+ </a>
+ <a href="https://www.eclipse.org/legal" target="_blank">
+ > Legal
+ </a>
+ <a href="https://www.eclipse.org/legal/epl-2.0/" target="_blank">
+ > License
+ </a>
+ <a href="https://eclipse.org/security" target="_blank">
+ > Report a Vulnerability
+ </a>
+ </div>
+ </div>
+ </div>
+</footer>
+
+
+ </div>
+ <!-- /.row -->
+</div>
+<!-- /.container -->
+</div>
+<!-- /#main -->
+ </div>
+
+</body>
+</html>
diff --git a/1.0/protocol-examples-policies-deletepolicy.html b/1.0/protocol-examples-policies-deletepolicy.html
new file mode 100644
index 0000000..e4ed530
--- /dev/null
+++ b/1.0/protocol-examples-policies-deletepolicy.html
@@ -0,0 +1,1550 @@
+<!DOCTYPE html>
+<html>
+<head>
+ <meta charset="utf-8">
+<meta http-equiv="X-UA-Compatible" content="IE=edge">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="description" content="">
+<meta name="keywords" content=" examples, delete policy">
+<title> Delete a Policy • Eclipse Ditto • a digital twin framework</title>
+
+<link rel="stylesheet" href="css/syntax.css">
+<link rel="stylesheet" type="text/css" href="//cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/modern-business.css">
+<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/customstyles.css">
+<link rel="stylesheet" href="css/boxshadowproperties.css">
+<link rel="stylesheet" href="css/theme-ditto.css">
+<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:400,700|Source+Code+Pro:300,600|Titillium+Web:400,600,700">
+
+<script src="//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.4/jquery.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/js/bootstrap.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/anchor-js/2.0.0/anchor.min.js" crossorigin="anonymous"></script>
+<script src="js/toc.js"></script>
+<script src="js/customscripts.js"></script>
+
+<script type="application/ld+json">
+{
+ "@context": "http://schema.org",
+ "@type": "Organization",
+ "url": "https://eclipse.org/ditto/",
+ "logo": "https://eclipse.org/ditto/images/ditto.svg"
+}
+</script>
+
+<link rel="icon" type="image/png" href="images/favicon-16x16.png" sizes="16x16">
+<link rel="icon" type="image/png" href="images/favicon-32x32.png" sizes="32x32">
+<link rel="icon" type="image/png" href="images/favicon-96x96.png" sizes="96x96">
+
+<link rel="alternate" type="application/rss+xml" title="Eclipse Ditto Blog" href="https://www.eclipse.org/ditto/feed.xml">
+
+<!-- Eclipse Foundation cookie consent: -->
+<link rel="stylesheet" type="text/css" href="//www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css" />
+<script src="//www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+ <script>
+ $(document).ready(function() {
+ $("#tg-sb-link").click(function() {
+ $("#tg-sb-sidebar").toggle();
+ $("#tg-sb-content").toggleClass('col-md-9');
+ $("#tg-sb-content").toggleClass('col-md-12');
+ $("#tg-sb-icon").toggleClass('fa-toggle-on');
+ $("#tg-sb-icon").toggleClass('fa-toggle-off');
+ });
+ });
+ </script>
+</head>
+
+
+<script>
+ (function(w,d,s,l,i){
+ w[l]=w[l]||[];
+ w[l].push({'gtm.start':
+ new Date().getTime(),event:'gtm.js'});
+ var f=d.getElementsByTagName(s)[0],
+ j=d.createElement(s),
+ dl=l!='dataLayer'?'&l='+l:'';
+ j.async=true;
+ j.src='https://www.googletagmanager.com/gtm.js?id='+i+dl;
+ f.parentNode.insertBefore(j,f);
+ })(window,document,'script','dataLayer','GTM-5WLCZXC');
+</script>
+
+
+
+<body>
+<!-- Navigation -->
+<nav class="navbar navbar-inverse navbar-fixed-top">
+ <div class="container topnavlinks">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-ditto-home" href="index.html"> <img src="images/ditto_allwhite_symbolonly.svg" class="ditto-navbar-symbol" alt="Home"> <img src="images/ditto_allwhite_textonly.svg" class="ditto-navbar-symbol-text" alt="Ditto"></a>
+ </div>
+ <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
+ <ul class="nav navbar-nav navbar-right">
+ <!-- toggle sidebar button -->
+ <!--<li><a id="tg-sb-link" href="#"><i id="tg-sb-icon" class="fa fa-toggle-on"></i> Nav</a></li>-->
+ <!-- entries without drop-downs appear here -->
+
+
+
+
+
+
+
+ <li><a href="blog.html">Blog</a></li>
+
+
+
+ <li><a href="intro-overview.html">Documentation</a></li>
+
+
+
+ <li><a href="http-api-doc.html">HTTP API</a></li>
+
+
+
+ <li><a href="https://ditto.eclipse.org" target="_blank">Sandbox</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">GitHub</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">GitHub examples</a></li>
+
+
+
+ <!-- entries with drop-downs appear here -->
+ <!-- conditional logic to control which topnav appears for the audience defined in the configuration file.-->
+
+
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Links<b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+
+ <li><a href="https://projects.eclipse.org/projects/iot.ditto" target="_blank">Eclipse Ditto Project</a></li>
+
+
+
+ <li><a href="https://www.eclipse.org/forums/index.php/f/364/" target="_blank">Forum</a></li>
+
+
+
+ <li><a href="https://ci.eclipse.org/ditto/" target="_blank">Jenkins</a></li>
+
+
+
+ <li><a href="https://dev.eclipse.org/mhonarc/lists/ditto-dev/" target="_blank">Mailing list archives</a></li>
+
+
+
+ <li><a href="https://gitter.im/eclipse/ditto" target="_blank">Gitter.im chat</a></li>
+
+
+ </ul>
+ </li>
+
+
+
+ <!--comment out this block if you want to hide search-->
+ <li>
+ <!--start search-->
+ <div id="search-demo-container">
+ <input type="text" id="search-input" placeholder="search...">
+ <ul id="results-container"></ul>
+ </div>
+ <script src="//cdnjs.cloudflare.com/ajax/libs/simple-jekyll-search/0.0.9/jekyll-search.js" type="text/javascript"></script>
+ <script type="text/javascript">
+ SimpleJekyllSearch.init({
+ searchInput: document.getElementById('search-input'),
+ resultsContainer: document.getElementById('results-container'),
+ dataSource: 'search.json',
+ searchResultTemplate: '<li><a href="{url}" title="Delete a Policy">{title}</a></li>',
+ noResultsText: 'No results found.',
+ limit: 10,
+ fuzzy: true,
+ })
+ </script>
+ <!--end search-->
+ </li>
+ </ul>
+ </div>
+ </div>
+ <!-- /.container -->
+</nav>
+
+<!-- Page Content -->
+<div class="container">
+ <div id="main">
+ <!-- Content Row -->
+ <div class="row">
+
+
+ <!-- Sidebar Column -->
+ <div class="col-md-3" id="tg-sb-sidebar">
+
+
+<ul id="mysidebar" class="nav">
+ <li class="sidebarTitle">
+ <label for="docVersion">Eclipse Ditto version:</label>
+ <div class="select-wrapper">
+ <select id="docVersion" name="docVersion">
+
+ <option value="">development</option>
+
+ <option value="1.0">1.0</option>
+
+ <option value="1.1">1.1</option>
+
+ </select>
+ </div>
+ <div id="dev-warning">
+ <div markdown="span" class="alert alert-warning" role="alert" style="font-size:0.6em"><i class="fa fa-warning"></i> <b>Important:</b> This documentation reflects the latest 'development'. You might want to choose a released version.</div>
+ </div>
+ </li>
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Introduction</a>
+ <ul>
+
+
+
+ <li><a href="intro-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="intro-digitaltwins.html">Digital twins</a></li>
+
+
+
+
+
+
+ <li><a href="intro-hello-world.html">Hello world</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Release Notes</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_100.html">1.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_090.html">0.9.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_080.html">0.8.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Milestone releases</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_100-M2.html">1.0.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_100-M1a.html">1.0.0-M1a</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M2.html">0.9.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M1.html">0.9.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M3.html">0.8.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M2.html">0.8.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M1.html">0.8.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M2.html">0.3.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M1.html">0.3.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_020-M1.html">0.2.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M3.html">0.1.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M1.html">0.1.0-M1</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Installation</a>
+ <ul>
+
+
+
+ <li><a href="installation-building.html">Building Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-running.html">Running Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-operating.html">Operating Ditto</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Basic concepts</a>
+ <ul>
+
+
+
+ <li><a href="basic-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Model entities</a>
+ <ul>
+
+
+
+ <li><a href="basic-thing.html">Thing</a></li>
+
+
+
+
+
+ <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
+
+
+
+
+
+ <li><a href="basic-feature.html">Feature</a></li>
+
+
+
+
+
+ <li><a href="basic-policy.html">Policy</a></li>
+
+
+
+
+
+ <li><a href="basic-namespaces-and-names.html">Namespaces and Names</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-auth.html">Authentication and Authorization</a></li>
+
+
+
+
+
+
+ <li><a href="basic-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="basic-signals.html">Signals</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Signal types</a>
+ <ul>
+
+
+
+ <li><a href="basic-signals-command.html">Command</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-commandresponse.html">Command response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-errorresponse.html">Error response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-event.html">Event</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-apis.html">APIs</a></li>
+
+
+
+
+
+
+ <li><a href="basic-connections.html">Connections</a></li>
+
+
+
+
+
+
+ <li><a href="basic-placeholders.html">Placeholders</a></li>
+
+
+
+
+
+
+ <li><a href="basic-changenotifications.html">Change notifications</a></li>
+
+
+
+
+
+
+ <li><a href="basic-rql.html">RQL expressions</a></li>
+
+
+
+
+
+
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
+ <li><a href="basic-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Architecture</a>
+ <ul>
+
+
+
+ <li><a href="architecture-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Services</a>
+ <ul>
+
+
+
+ <li><a href="architecture-services-policies.html">Policies</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things.html">Things</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things-search.html">Things-Search</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-connectivity.html">Connectivity</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-concierge.html">Concierge</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-gateway.html">Gateway</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>HTTP API</a>
+ <ul>
+
+
+
+ <li><a href="httpapi-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-concepts.html">Concepts</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-protocol-bindings-websocket.html">WebSocket protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-sse.html">Server sent events</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Connectivity API</a>
+ <ul>
+
+
+
+ <li><a href="connectivity-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-manage-connections.html">Manage connections</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp091.html">AMQP 0.9.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp10.html">AMQP 1.0 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-kafka2.html">Kafka 2.x protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-mapping.html">Payload mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-header-mapping.html">Header mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-tls-certificates.html">TLS certificates</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Client SDK</a>
+ <ul>
+
+
+
+ <li><a href="client-sdk-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-java.html">Java</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-javascript.html">JavaScript</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Ditto Protocol</a>
+ <ul>
+
+
+
+ <li><a href="protocol-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-twinlive.html">Twin/live channel</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification.html">Specification</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-topic.html">Protocol topic</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-things.html">Things group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-delete.html">Delete</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ search/messages</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-search.html">Search</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-messages.html">Messages</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-bindings.html">Bindings</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-examples.html">Examples</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-creatething.html">Create a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletething.html">Delete a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifything.html">Modify a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievething.html">Retrieve a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethings.html">Retrieve multiple Things</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattributes.html">Delete Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattributes.html">Modify Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattributes.html">Retrieve Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattribute.html">Create a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattribute.html">Delete a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattribute.html">Modify a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattribute.html">Retrieve a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createthingdefinition.html">Create a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletethingdefinition.html">Delete a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifythingdefinition.html">Modify a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethingdefinition.html">Retrieve a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeatures.html">Create Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeatures.html">Delete Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeatures.html">Modify Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeatures.html">Retrieve Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeature.html">Create a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeature.html">Delete a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeature.html">Modify a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeature.html">Retrieve a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdefinition.html">Create Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedefinition.html">Delete Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydefinition.html">Modify Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedefinition.html">Retrieve Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperties.html">Create Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperties.html">Delete Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperties.html">Modify Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperties.html">Retrieve Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperty.html">Create a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperty.html">Delete a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperty.html">Modify a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperty.html">Retrieve a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li class="active"><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li><a href="sandbox.html">Sandbox</a></li>
+
+
+
+
+
+ <li><a href="presentations.html">Presentations</a></li>
+
+
+
+
+
+ <li><a href="glossary.html">Glossary</a></li>
+
+
+
+
+
+ <li><a href="feedback.html">Feedback</a></li>
+
+
+
+
+
+ <p class="external">
+ <a href="#" id="collapseAll">Collapse All</a> | <a href="#" id="expandAll">Expand All</a>
+ </p>
+
+</ul>
+
+<!-- this highlights the active parent class in the sidebar. this is critical so that the parent expands when you're viewing a page. This must appear below the sidebar code above. Otherwise, if placed inside customscripts.js, the script runs before the sidebar code runs and the class never gets inserted.-->
+<script>$("li.active").parents('li').toggleClass("active");
+
+$(function() {
+ $("#dev-warning").hide();
+ changeSelectedDocVersionDropdownSelection($("#docVersion")[0]);
+ $("#docVersion").change(changeSelectedDocVersion);
+});
+
+function changeSelectedDocVersionDropdownSelection(element) {
+ var pathName = window.location.pathname;
+
+ var versionOptions = element.options;
+ for (var i = 0; i < versionOptions.length; i++) {
+ var versionValue = versionOptions[i].value;
+ if ((versionValue !== "") && pathName.startsWith("/ditto/"+versionValue+"/")) {
+ $("#docVersion").val(versionValue).change();
+ return;
+ }
+ }
+ // fallback: dev with "empty" version value:
+ $("#docVersion").val("").change();
+ $("#dev-warning").show();
+}
+function changeSelectedDocVersion() {
+ var versionValue = $('#docVersion').val();
+ var remainingPath = window.location.pathname.replace("/ditto/", "");
+ var versionMatch = remainingPath.match("([0-9].[0.9])/(.*)");
+ if (versionValue === "" && !versionMatch) {
+ // do nothing, we're already on the correct "dev" version
+ } else if (versionMatch && (versionValue === versionMatch[1])) {
+ // do nothing, we're already on the correct version
+ } else {
+ if (versionValue === "" && versionMatch) {
+ window.location.pathname = "ditto/" + versionMatch[2];
+ } else if (versionValue === "") {
+ window.location.pathname = "ditto/" + remainingPath;
+ } else if (versionMatch) {
+ window.location.pathname = "ditto/" + versionValue + "/" + versionMatch[2];
+ } else {
+ window.location.pathname = "ditto/" + versionValue + "/" + remainingPath;
+ }
+ }
+}
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Delete a Policy</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+
+
+
+<!-- this handles the automatic toc. use ## for subheads to auto-generate the on-page minitoc. if you use html tags, you must supply an ID for the heading element in order for it to appear in the minitoc. -->
+<script>
+$( document ).ready(function() {
+ // Handler for .ready() called.
+
+$('#toc').toc({ minimumHeaders: 0, listType: 'ul', showSpeed: 0, headers: 'h2,h3,h4' });
+
+/* this offset helps account for the space taken up by the floating toolbar. */
+$('#toc').on('click', 'a', function() {
+ var target = $(this.getAttribute('href'))
+ , scroll_target = target.offset().top
+
+ $(window).scrollTop(scroll_target - 10);
+ return false
+})
+
+});
+</script>
+
+<div id="toc"></div>
+
+
+
+
+
+
+
+
+
+
+<h2 id="deletepolicy">DeletePolicy</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/the_policy_id/policies/commands/delete"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="deletepolicyresponse">DeletePolicyResponse</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/the_policy_id/policies/commands/delete"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">204</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+
+
+ <div class="tags">
+
+ </div>
+
+</div>
+
+<hr class="shaded"/>
+
+<footer>
+ <div class="row">
+ <div class="col-lg-12 footer">
+ <div class="logo">
+ <a href="https://eclipse.org"><img src="images/eclipse_foundation_logo.svg" alt="Eclipse logo"/></a>
+ </div>
+ <p class="notice">
+ ©2020 Eclipse Ditto.
+ Site last generated: Jul 1, 2020 <br />
+ </p>
+ <div class="quickLinks">
+ <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
+ > Privacy Policy
+ </a>
+ <a href="https://www.eclipse.org/legal/termsofuse.php" target="_blank">
+ > Terms of Use
+ </a>
+ <a href="https://www.eclipse.org/legal/copyright.php" target="_blank">
+ > Copyright Agent
+ </a>
+ <a href="https://www.eclipse.org/legal" target="_blank">
+ > Legal
+ </a>
+ <a href="https://www.eclipse.org/legal/epl-2.0/" target="_blank">
+ > License
+ </a>
+ <a href="https://eclipse.org/security" target="_blank">
+ > Report a Vulnerability
+ </a>
+ </div>
+ </div>
+ </div>
+</footer>
+
+
+ </div>
+ <!-- /.row -->
+</div>
+<!-- /.container -->
+</div>
+<!-- /#main -->
+ </div>
+
+</body>
+</html>
diff --git a/1.0/protocol-examples-policies-deletepolicyentry.html b/1.0/protocol-examples-policies-deletepolicyentry.html
new file mode 100644
index 0000000..16d7bcd
--- /dev/null
+++ b/1.0/protocol-examples-policies-deletepolicyentry.html
@@ -0,0 +1,1550 @@
+<!DOCTYPE html>
+<html>
+<head>
+ <meta charset="utf-8">
+<meta http-equiv="X-UA-Compatible" content="IE=edge">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="description" content="">
+<meta name="keywords" content=" examples, delete policy entry">
+<title> Delete a Policy entry • Eclipse Ditto • a digital twin framework</title>
+
+<link rel="stylesheet" href="css/syntax.css">
+<link rel="stylesheet" type="text/css" href="//cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/modern-business.css">
+<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/customstyles.css">
+<link rel="stylesheet" href="css/boxshadowproperties.css">
+<link rel="stylesheet" href="css/theme-ditto.css">
+<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:400,700|Source+Code+Pro:300,600|Titillium+Web:400,600,700">
+
+<script src="//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.4/jquery.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/js/bootstrap.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/anchor-js/2.0.0/anchor.min.js" crossorigin="anonymous"></script>
+<script src="js/toc.js"></script>
+<script src="js/customscripts.js"></script>
+
+<script type="application/ld+json">
+{
+ "@context": "http://schema.org",
+ "@type": "Organization",
+ "url": "https://eclipse.org/ditto/",
+ "logo": "https://eclipse.org/ditto/images/ditto.svg"
+}
+</script>
+
+<link rel="icon" type="image/png" href="images/favicon-16x16.png" sizes="16x16">
+<link rel="icon" type="image/png" href="images/favicon-32x32.png" sizes="32x32">
+<link rel="icon" type="image/png" href="images/favicon-96x96.png" sizes="96x96">
+
+<link rel="alternate" type="application/rss+xml" title="Eclipse Ditto Blog" href="https://www.eclipse.org/ditto/feed.xml">
+
+<!-- Eclipse Foundation cookie consent: -->
+<link rel="stylesheet" type="text/css" href="//www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css" />
+<script src="//www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+ <script>
+ $(document).ready(function() {
+ $("#tg-sb-link").click(function() {
+ $("#tg-sb-sidebar").toggle();
+ $("#tg-sb-content").toggleClass('col-md-9');
+ $("#tg-sb-content").toggleClass('col-md-12');
+ $("#tg-sb-icon").toggleClass('fa-toggle-on');
+ $("#tg-sb-icon").toggleClass('fa-toggle-off');
+ });
+ });
+ </script>
+</head>
+
+
+<script>
+ (function(w,d,s,l,i){
+ w[l]=w[l]||[];
+ w[l].push({'gtm.start':
+ new Date().getTime(),event:'gtm.js'});
+ var f=d.getElementsByTagName(s)[0],
+ j=d.createElement(s),
+ dl=l!='dataLayer'?'&l='+l:'';
+ j.async=true;
+ j.src='https://www.googletagmanager.com/gtm.js?id='+i+dl;
+ f.parentNode.insertBefore(j,f);
+ })(window,document,'script','dataLayer','GTM-5WLCZXC');
+</script>
+
+
+
+<body>
+<!-- Navigation -->
+<nav class="navbar navbar-inverse navbar-fixed-top">
+ <div class="container topnavlinks">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-ditto-home" href="index.html"> <img src="images/ditto_allwhite_symbolonly.svg" class="ditto-navbar-symbol" alt="Home"> <img src="images/ditto_allwhite_textonly.svg" class="ditto-navbar-symbol-text" alt="Ditto"></a>
+ </div>
+ <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
+ <ul class="nav navbar-nav navbar-right">
+ <!-- toggle sidebar button -->
+ <!--<li><a id="tg-sb-link" href="#"><i id="tg-sb-icon" class="fa fa-toggle-on"></i> Nav</a></li>-->
+ <!-- entries without drop-downs appear here -->
+
+
+
+
+
+
+
+ <li><a href="blog.html">Blog</a></li>
+
+
+
+ <li><a href="intro-overview.html">Documentation</a></li>
+
+
+
+ <li><a href="http-api-doc.html">HTTP API</a></li>
+
+
+
+ <li><a href="https://ditto.eclipse.org" target="_blank">Sandbox</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">GitHub</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">GitHub examples</a></li>
+
+
+
+ <!-- entries with drop-downs appear here -->
+ <!-- conditional logic to control which topnav appears for the audience defined in the configuration file.-->
+
+
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Links<b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+
+ <li><a href="https://projects.eclipse.org/projects/iot.ditto" target="_blank">Eclipse Ditto Project</a></li>
+
+
+
+ <li><a href="https://www.eclipse.org/forums/index.php/f/364/" target="_blank">Forum</a></li>
+
+
+
+ <li><a href="https://ci.eclipse.org/ditto/" target="_blank">Jenkins</a></li>
+
+
+
+ <li><a href="https://dev.eclipse.org/mhonarc/lists/ditto-dev/" target="_blank">Mailing list archives</a></li>
+
+
+
+ <li><a href="https://gitter.im/eclipse/ditto" target="_blank">Gitter.im chat</a></li>
+
+
+ </ul>
+ </li>
+
+
+
+ <!--comment out this block if you want to hide search-->
+ <li>
+ <!--start search-->
+ <div id="search-demo-container">
+ <input type="text" id="search-input" placeholder="search...">
+ <ul id="results-container"></ul>
+ </div>
+ <script src="//cdnjs.cloudflare.com/ajax/libs/simple-jekyll-search/0.0.9/jekyll-search.js" type="text/javascript"></script>
+ <script type="text/javascript">
+ SimpleJekyllSearch.init({
+ searchInput: document.getElementById('search-input'),
+ resultsContainer: document.getElementById('results-container'),
+ dataSource: 'search.json',
+ searchResultTemplate: '<li><a href="{url}" title="Delete a Policy entry">{title}</a></li>',
+ noResultsText: 'No results found.',
+ limit: 10,
+ fuzzy: true,
+ })
+ </script>
+ <!--end search-->
+ </li>
+ </ul>
+ </div>
+ </div>
+ <!-- /.container -->
+</nav>
+
+<!-- Page Content -->
+<div class="container">
+ <div id="main">
+ <!-- Content Row -->
+ <div class="row">
+
+
+ <!-- Sidebar Column -->
+ <div class="col-md-3" id="tg-sb-sidebar">
+
+
+<ul id="mysidebar" class="nav">
+ <li class="sidebarTitle">
+ <label for="docVersion">Eclipse Ditto version:</label>
+ <div class="select-wrapper">
+ <select id="docVersion" name="docVersion">
+
+ <option value="">development</option>
+
+ <option value="1.0">1.0</option>
+
+ <option value="1.1">1.1</option>
+
+ </select>
+ </div>
+ <div id="dev-warning">
+ <div markdown="span" class="alert alert-warning" role="alert" style="font-size:0.6em"><i class="fa fa-warning"></i> <b>Important:</b> This documentation reflects the latest 'development'. You might want to choose a released version.</div>
+ </div>
+ </li>
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Introduction</a>
+ <ul>
+
+
+
+ <li><a href="intro-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="intro-digitaltwins.html">Digital twins</a></li>
+
+
+
+
+
+
+ <li><a href="intro-hello-world.html">Hello world</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Release Notes</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_100.html">1.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_090.html">0.9.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_080.html">0.8.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Milestone releases</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_100-M2.html">1.0.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_100-M1a.html">1.0.0-M1a</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M2.html">0.9.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M1.html">0.9.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M3.html">0.8.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M2.html">0.8.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M1.html">0.8.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M2.html">0.3.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M1.html">0.3.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_020-M1.html">0.2.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M3.html">0.1.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M1.html">0.1.0-M1</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Installation</a>
+ <ul>
+
+
+
+ <li><a href="installation-building.html">Building Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-running.html">Running Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-operating.html">Operating Ditto</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Basic concepts</a>
+ <ul>
+
+
+
+ <li><a href="basic-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Model entities</a>
+ <ul>
+
+
+
+ <li><a href="basic-thing.html">Thing</a></li>
+
+
+
+
+
+ <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
+
+
+
+
+
+ <li><a href="basic-feature.html">Feature</a></li>
+
+
+
+
+
+ <li><a href="basic-policy.html">Policy</a></li>
+
+
+
+
+
+ <li><a href="basic-namespaces-and-names.html">Namespaces and Names</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-auth.html">Authentication and Authorization</a></li>
+
+
+
+
+
+
+ <li><a href="basic-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="basic-signals.html">Signals</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Signal types</a>
+ <ul>
+
+
+
+ <li><a href="basic-signals-command.html">Command</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-commandresponse.html">Command response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-errorresponse.html">Error response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-event.html">Event</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-apis.html">APIs</a></li>
+
+
+
+
+
+
+ <li><a href="basic-connections.html">Connections</a></li>
+
+
+
+
+
+
+ <li><a href="basic-placeholders.html">Placeholders</a></li>
+
+
+
+
+
+
+ <li><a href="basic-changenotifications.html">Change notifications</a></li>
+
+
+
+
+
+
+ <li><a href="basic-rql.html">RQL expressions</a></li>
+
+
+
+
+
+
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
+ <li><a href="basic-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Architecture</a>
+ <ul>
+
+
+
+ <li><a href="architecture-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Services</a>
+ <ul>
+
+
+
+ <li><a href="architecture-services-policies.html">Policies</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things.html">Things</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things-search.html">Things-Search</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-connectivity.html">Connectivity</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-concierge.html">Concierge</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-gateway.html">Gateway</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>HTTP API</a>
+ <ul>
+
+
+
+ <li><a href="httpapi-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-concepts.html">Concepts</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-protocol-bindings-websocket.html">WebSocket protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-sse.html">Server sent events</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Connectivity API</a>
+ <ul>
+
+
+
+ <li><a href="connectivity-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-manage-connections.html">Manage connections</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp091.html">AMQP 0.9.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp10.html">AMQP 1.0 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-kafka2.html">Kafka 2.x protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-mapping.html">Payload mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-header-mapping.html">Header mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-tls-certificates.html">TLS certificates</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Client SDK</a>
+ <ul>
+
+
+
+ <li><a href="client-sdk-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-java.html">Java</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-javascript.html">JavaScript</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Ditto Protocol</a>
+ <ul>
+
+
+
+ <li><a href="protocol-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-twinlive.html">Twin/live channel</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification.html">Specification</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-topic.html">Protocol topic</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-things.html">Things group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-delete.html">Delete</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ search/messages</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-search.html">Search</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-messages.html">Messages</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-bindings.html">Bindings</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-examples.html">Examples</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-creatething.html">Create a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletething.html">Delete a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifything.html">Modify a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievething.html">Retrieve a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethings.html">Retrieve multiple Things</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattributes.html">Delete Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattributes.html">Modify Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattributes.html">Retrieve Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattribute.html">Create a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattribute.html">Delete a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattribute.html">Modify a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattribute.html">Retrieve a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createthingdefinition.html">Create a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletethingdefinition.html">Delete a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifythingdefinition.html">Modify a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethingdefinition.html">Retrieve a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeatures.html">Create Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeatures.html">Delete Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeatures.html">Modify Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeatures.html">Retrieve Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeature.html">Create a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeature.html">Delete a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeature.html">Modify a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeature.html">Retrieve a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdefinition.html">Create Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedefinition.html">Delete Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydefinition.html">Modify Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedefinition.html">Retrieve Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperties.html">Create Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperties.html">Delete Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperties.html">Modify Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperties.html">Retrieve Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperty.html">Create a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperty.html">Delete a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperty.html">Modify a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperty.html">Retrieve a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li class="active"><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li><a href="sandbox.html">Sandbox</a></li>
+
+
+
+
+
+ <li><a href="presentations.html">Presentations</a></li>
+
+
+
+
+
+ <li><a href="glossary.html">Glossary</a></li>
+
+
+
+
+
+ <li><a href="feedback.html">Feedback</a></li>
+
+
+
+
+
+ <p class="external">
+ <a href="#" id="collapseAll">Collapse All</a> | <a href="#" id="expandAll">Expand All</a>
+ </p>
+
+</ul>
+
+<!-- this highlights the active parent class in the sidebar. this is critical so that the parent expands when you're viewing a page. This must appear below the sidebar code above. Otherwise, if placed inside customscripts.js, the script runs before the sidebar code runs and the class never gets inserted.-->
+<script>$("li.active").parents('li').toggleClass("active");
+
+$(function() {
+ $("#dev-warning").hide();
+ changeSelectedDocVersionDropdownSelection($("#docVersion")[0]);
+ $("#docVersion").change(changeSelectedDocVersion);
+});
+
+function changeSelectedDocVersionDropdownSelection(element) {
+ var pathName = window.location.pathname;
+
+ var versionOptions = element.options;
+ for (var i = 0; i < versionOptions.length; i++) {
+ var versionValue = versionOptions[i].value;
+ if ((versionValue !== "") && pathName.startsWith("/ditto/"+versionValue+"/")) {
+ $("#docVersion").val(versionValue).change();
+ return;
+ }
+ }
+ // fallback: dev with "empty" version value:
+ $("#docVersion").val("").change();
+ $("#dev-warning").show();
+}
+function changeSelectedDocVersion() {
+ var versionValue = $('#docVersion').val();
+ var remainingPath = window.location.pathname.replace("/ditto/", "");
+ var versionMatch = remainingPath.match("([0-9].[0.9])/(.*)");
+ if (versionValue === "" && !versionMatch) {
+ // do nothing, we're already on the correct "dev" version
+ } else if (versionMatch && (versionValue === versionMatch[1])) {
+ // do nothing, we're already on the correct version
+ } else {
+ if (versionValue === "" && versionMatch) {
+ window.location.pathname = "ditto/" + versionMatch[2];
+ } else if (versionValue === "") {
+ window.location.pathname = "ditto/" + remainingPath;
+ } else if (versionMatch) {
+ window.location.pathname = "ditto/" + versionValue + "/" + versionMatch[2];
+ } else {
+ window.location.pathname = "ditto/" + versionValue + "/" + remainingPath;
+ }
+ }
+}
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Delete a Policy entry</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+
+
+
+<!-- this handles the automatic toc. use ## for subheads to auto-generate the on-page minitoc. if you use html tags, you must supply an ID for the heading element in order for it to appear in the minitoc. -->
+<script>
+$( document ).ready(function() {
+ // Handler for .ready() called.
+
+$('#toc').toc({ minimumHeaders: 0, listType: 'ul', showSpeed: 0, headers: 'h2,h3,h4' });
+
+/* this offset helps account for the space taken up by the floating toolbar. */
+$('#toc').on('click', 'a', function() {
+ var target = $(this.getAttribute('href'))
+ , scroll_target = target.offset().top
+
+ $(window).scrollTop(scroll_target - 10);
+ return false
+})
+
+});
+</script>
+
+<div id="toc"></div>
+
+
+
+
+
+
+
+
+
+
+<h2 id="deletepolicyentry">DeletePolicyEntry</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/the_policy_id/policies/commands/delete"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/entries/the_label"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="deletepolicyentryresponse">DeletePolicyEntryResponse</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/the_policy_id/policies/commands/delete"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/entries/the_label"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">204</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+
+
+ <div class="tags">
+
+ </div>
+
+</div>
+
+<hr class="shaded"/>
+
+<footer>
+ <div class="row">
+ <div class="col-lg-12 footer">
+ <div class="logo">
+ <a href="https://eclipse.org"><img src="images/eclipse_foundation_logo.svg" alt="Eclipse logo"/></a>
+ </div>
+ <p class="notice">
+ ©2020 Eclipse Ditto.
+ Site last generated: Jul 1, 2020 <br />
+ </p>
+ <div class="quickLinks">
+ <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
+ > Privacy Policy
+ </a>
+ <a href="https://www.eclipse.org/legal/termsofuse.php" target="_blank">
+ > Terms of Use
+ </a>
+ <a href="https://www.eclipse.org/legal/copyright.php" target="_blank">
+ > Copyright Agent
+ </a>
+ <a href="https://www.eclipse.org/legal" target="_blank">
+ > Legal
+ </a>
+ <a href="https://www.eclipse.org/legal/epl-2.0/" target="_blank">
+ > License
+ </a>
+ <a href="https://eclipse.org/security" target="_blank">
+ > Report a Vulnerability
+ </a>
+ </div>
+ </div>
+ </div>
+</footer>
+
+
+ </div>
+ <!-- /.row -->
+</div>
+<!-- /.container -->
+</div>
+<!-- /#main -->
+ </div>
+
+</body>
+</html>
diff --git a/1.0/protocol-examples-policies-deleteresource.html b/1.0/protocol-examples-policies-deleteresource.html
new file mode 100644
index 0000000..a0650e0
--- /dev/null
+++ b/1.0/protocol-examples-policies-deleteresource.html
@@ -0,0 +1,1550 @@
+<!DOCTYPE html>
+<html>
+<head>
+ <meta charset="utf-8">
+<meta http-equiv="X-UA-Compatible" content="IE=edge">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="description" content="">
+<meta name="keywords" content=" examples, delete resource">
+<title> Delete a resource • Eclipse Ditto • a digital twin framework</title>
+
+<link rel="stylesheet" href="css/syntax.css">
+<link rel="stylesheet" type="text/css" href="//cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/modern-business.css">
+<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/customstyles.css">
+<link rel="stylesheet" href="css/boxshadowproperties.css">
+<link rel="stylesheet" href="css/theme-ditto.css">
+<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:400,700|Source+Code+Pro:300,600|Titillium+Web:400,600,700">
+
+<script src="//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.4/jquery.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/js/bootstrap.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/anchor-js/2.0.0/anchor.min.js" crossorigin="anonymous"></script>
+<script src="js/toc.js"></script>
+<script src="js/customscripts.js"></script>
+
+<script type="application/ld+json">
+{
+ "@context": "http://schema.org",
+ "@type": "Organization",
+ "url": "https://eclipse.org/ditto/",
+ "logo": "https://eclipse.org/ditto/images/ditto.svg"
+}
+</script>
+
+<link rel="icon" type="image/png" href="images/favicon-16x16.png" sizes="16x16">
+<link rel="icon" type="image/png" href="images/favicon-32x32.png" sizes="32x32">
+<link rel="icon" type="image/png" href="images/favicon-96x96.png" sizes="96x96">
+
+<link rel="alternate" type="application/rss+xml" title="Eclipse Ditto Blog" href="https://www.eclipse.org/ditto/feed.xml">
+
+<!-- Eclipse Foundation cookie consent: -->
+<link rel="stylesheet" type="text/css" href="//www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css" />
+<script src="//www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+ <script>
+ $(document).ready(function() {
+ $("#tg-sb-link").click(function() {
+ $("#tg-sb-sidebar").toggle();
+ $("#tg-sb-content").toggleClass('col-md-9');
+ $("#tg-sb-content").toggleClass('col-md-12');
+ $("#tg-sb-icon").toggleClass('fa-toggle-on');
+ $("#tg-sb-icon").toggleClass('fa-toggle-off');
+ });
+ });
+ </script>
+</head>
+
+
+<script>
+ (function(w,d,s,l,i){
+ w[l]=w[l]||[];
+ w[l].push({'gtm.start':
+ new Date().getTime(),event:'gtm.js'});
+ var f=d.getElementsByTagName(s)[0],
+ j=d.createElement(s),
+ dl=l!='dataLayer'?'&l='+l:'';
+ j.async=true;
+ j.src='https://www.googletagmanager.com/gtm.js?id='+i+dl;
+ f.parentNode.insertBefore(j,f);
+ })(window,document,'script','dataLayer','GTM-5WLCZXC');
+</script>
+
+
+
+<body>
+<!-- Navigation -->
+<nav class="navbar navbar-inverse navbar-fixed-top">
+ <div class="container topnavlinks">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-ditto-home" href="index.html"> <img src="images/ditto_allwhite_symbolonly.svg" class="ditto-navbar-symbol" alt="Home"> <img src="images/ditto_allwhite_textonly.svg" class="ditto-navbar-symbol-text" alt="Ditto"></a>
+ </div>
+ <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
+ <ul class="nav navbar-nav navbar-right">
+ <!-- toggle sidebar button -->
+ <!--<li><a id="tg-sb-link" href="#"><i id="tg-sb-icon" class="fa fa-toggle-on"></i> Nav</a></li>-->
+ <!-- entries without drop-downs appear here -->
+
+
+
+
+
+
+
+ <li><a href="blog.html">Blog</a></li>
+
+
+
+ <li><a href="intro-overview.html">Documentation</a></li>
+
+
+
+ <li><a href="http-api-doc.html">HTTP API</a></li>
+
+
+
+ <li><a href="https://ditto.eclipse.org" target="_blank">Sandbox</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">GitHub</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">GitHub examples</a></li>
+
+
+
+ <!-- entries with drop-downs appear here -->
+ <!-- conditional logic to control which topnav appears for the audience defined in the configuration file.-->
+
+
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Links<b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+
+ <li><a href="https://projects.eclipse.org/projects/iot.ditto" target="_blank">Eclipse Ditto Project</a></li>
+
+
+
+ <li><a href="https://www.eclipse.org/forums/index.php/f/364/" target="_blank">Forum</a></li>
+
+
+
+ <li><a href="https://ci.eclipse.org/ditto/" target="_blank">Jenkins</a></li>
+
+
+
+ <li><a href="https://dev.eclipse.org/mhonarc/lists/ditto-dev/" target="_blank">Mailing list archives</a></li>
+
+
+
+ <li><a href="https://gitter.im/eclipse/ditto" target="_blank">Gitter.im chat</a></li>
+
+
+ </ul>
+ </li>
+
+
+
+ <!--comment out this block if you want to hide search-->
+ <li>
+ <!--start search-->
+ <div id="search-demo-container">
+ <input type="text" id="search-input" placeholder="search...">
+ <ul id="results-container"></ul>
+ </div>
+ <script src="//cdnjs.cloudflare.com/ajax/libs/simple-jekyll-search/0.0.9/jekyll-search.js" type="text/javascript"></script>
+ <script type="text/javascript">
+ SimpleJekyllSearch.init({
+ searchInput: document.getElementById('search-input'),
+ resultsContainer: document.getElementById('results-container'),
+ dataSource: 'search.json',
+ searchResultTemplate: '<li><a href="{url}" title="Delete a resource">{title}</a></li>',
+ noResultsText: 'No results found.',
+ limit: 10,
+ fuzzy: true,
+ })
+ </script>
+ <!--end search-->
+ </li>
+ </ul>
+ </div>
+ </div>
+ <!-- /.container -->
+</nav>
+
+<!-- Page Content -->
+<div class="container">
+ <div id="main">
+ <!-- Content Row -->
+ <div class="row">
+
+
+ <!-- Sidebar Column -->
+ <div class="col-md-3" id="tg-sb-sidebar">
+
+
+<ul id="mysidebar" class="nav">
+ <li class="sidebarTitle">
+ <label for="docVersion">Eclipse Ditto version:</label>
+ <div class="select-wrapper">
+ <select id="docVersion" name="docVersion">
+
+ <option value="">development</option>
+
+ <option value="1.0">1.0</option>
+
+ <option value="1.1">1.1</option>
+
+ </select>
+ </div>
+ <div id="dev-warning">
+ <div markdown="span" class="alert alert-warning" role="alert" style="font-size:0.6em"><i class="fa fa-warning"></i> <b>Important:</b> This documentation reflects the latest 'development'. You might want to choose a released version.</div>
+ </div>
+ </li>
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Introduction</a>
+ <ul>
+
+
+
+ <li><a href="intro-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="intro-digitaltwins.html">Digital twins</a></li>
+
+
+
+
+
+
+ <li><a href="intro-hello-world.html">Hello world</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Release Notes</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_100.html">1.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_090.html">0.9.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_080.html">0.8.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Milestone releases</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_100-M2.html">1.0.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_100-M1a.html">1.0.0-M1a</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M2.html">0.9.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M1.html">0.9.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M3.html">0.8.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M2.html">0.8.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M1.html">0.8.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M2.html">0.3.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M1.html">0.3.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_020-M1.html">0.2.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M3.html">0.1.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M1.html">0.1.0-M1</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Installation</a>
+ <ul>
+
+
+
+ <li><a href="installation-building.html">Building Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-running.html">Running Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-operating.html">Operating Ditto</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Basic concepts</a>
+ <ul>
+
+
+
+ <li><a href="basic-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Model entities</a>
+ <ul>
+
+
+
+ <li><a href="basic-thing.html">Thing</a></li>
+
+
+
+
+
+ <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
+
+
+
+
+
+ <li><a href="basic-feature.html">Feature</a></li>
+
+
+
+
+
+ <li><a href="basic-policy.html">Policy</a></li>
+
+
+
+
+
+ <li><a href="basic-namespaces-and-names.html">Namespaces and Names</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-auth.html">Authentication and Authorization</a></li>
+
+
+
+
+
+
+ <li><a href="basic-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="basic-signals.html">Signals</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Signal types</a>
+ <ul>
+
+
+
+ <li><a href="basic-signals-command.html">Command</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-commandresponse.html">Command response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-errorresponse.html">Error response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-event.html">Event</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-apis.html">APIs</a></li>
+
+
+
+
+
+
+ <li><a href="basic-connections.html">Connections</a></li>
+
+
+
+
+
+
+ <li><a href="basic-placeholders.html">Placeholders</a></li>
+
+
+
+
+
+
+ <li><a href="basic-changenotifications.html">Change notifications</a></li>
+
+
+
+
+
+
+ <li><a href="basic-rql.html">RQL expressions</a></li>
+
+
+
+
+
+
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
+ <li><a href="basic-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Architecture</a>
+ <ul>
+
+
+
+ <li><a href="architecture-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Services</a>
+ <ul>
+
+
+
+ <li><a href="architecture-services-policies.html">Policies</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things.html">Things</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things-search.html">Things-Search</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-connectivity.html">Connectivity</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-concierge.html">Concierge</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-gateway.html">Gateway</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>HTTP API</a>
+ <ul>
+
+
+
+ <li><a href="httpapi-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-concepts.html">Concepts</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-protocol-bindings-websocket.html">WebSocket protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-sse.html">Server sent events</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Connectivity API</a>
+ <ul>
+
+
+
+ <li><a href="connectivity-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-manage-connections.html">Manage connections</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp091.html">AMQP 0.9.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp10.html">AMQP 1.0 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-kafka2.html">Kafka 2.x protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-mapping.html">Payload mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-header-mapping.html">Header mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-tls-certificates.html">TLS certificates</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Client SDK</a>
+ <ul>
+
+
+
+ <li><a href="client-sdk-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-java.html">Java</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-javascript.html">JavaScript</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Ditto Protocol</a>
+ <ul>
+
+
+
+ <li><a href="protocol-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-twinlive.html">Twin/live channel</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification.html">Specification</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-topic.html">Protocol topic</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-things.html">Things group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-delete.html">Delete</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ search/messages</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-search.html">Search</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-messages.html">Messages</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-bindings.html">Bindings</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-examples.html">Examples</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-creatething.html">Create a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletething.html">Delete a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifything.html">Modify a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievething.html">Retrieve a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethings.html">Retrieve multiple Things</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattributes.html">Delete Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattributes.html">Modify Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattributes.html">Retrieve Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattribute.html">Create a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattribute.html">Delete a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattribute.html">Modify a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattribute.html">Retrieve a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createthingdefinition.html">Create a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletethingdefinition.html">Delete a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifythingdefinition.html">Modify a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethingdefinition.html">Retrieve a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeatures.html">Create Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeatures.html">Delete Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeatures.html">Modify Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeatures.html">Retrieve Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeature.html">Create a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeature.html">Delete a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeature.html">Modify a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeature.html">Retrieve a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdefinition.html">Create Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedefinition.html">Delete Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydefinition.html">Modify Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedefinition.html">Retrieve Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperties.html">Create Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperties.html">Delete Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperties.html">Modify Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperties.html">Retrieve Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperty.html">Create a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperty.html">Delete a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperty.html">Modify a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperty.html">Retrieve a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li class="active"><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li><a href="sandbox.html">Sandbox</a></li>
+
+
+
+
+
+ <li><a href="presentations.html">Presentations</a></li>
+
+
+
+
+
+ <li><a href="glossary.html">Glossary</a></li>
+
+
+
+
+
+ <li><a href="feedback.html">Feedback</a></li>
+
+
+
+
+
+ <p class="external">
+ <a href="#" id="collapseAll">Collapse All</a> | <a href="#" id="expandAll">Expand All</a>
+ </p>
+
+</ul>
+
+<!-- this highlights the active parent class in the sidebar. this is critical so that the parent expands when you're viewing a page. This must appear below the sidebar code above. Otherwise, if placed inside customscripts.js, the script runs before the sidebar code runs and the class never gets inserted.-->
+<script>$("li.active").parents('li').toggleClass("active");
+
+$(function() {
+ $("#dev-warning").hide();
+ changeSelectedDocVersionDropdownSelection($("#docVersion")[0]);
+ $("#docVersion").change(changeSelectedDocVersion);
+});
+
+function changeSelectedDocVersionDropdownSelection(element) {
+ var pathName = window.location.pathname;
+
+ var versionOptions = element.options;
+ for (var i = 0; i < versionOptions.length; i++) {
+ var versionValue = versionOptions[i].value;
+ if ((versionValue !== "") && pathName.startsWith("/ditto/"+versionValue+"/")) {
+ $("#docVersion").val(versionValue).change();
+ return;
+ }
+ }
+ // fallback: dev with "empty" version value:
+ $("#docVersion").val("").change();
+ $("#dev-warning").show();
+}
+function changeSelectedDocVersion() {
+ var versionValue = $('#docVersion').val();
+ var remainingPath = window.location.pathname.replace("/ditto/", "");
+ var versionMatch = remainingPath.match("([0-9].[0.9])/(.*)");
+ if (versionValue === "" && !versionMatch) {
+ // do nothing, we're already on the correct "dev" version
+ } else if (versionMatch && (versionValue === versionMatch[1])) {
+ // do nothing, we're already on the correct version
+ } else {
+ if (versionValue === "" && versionMatch) {
+ window.location.pathname = "ditto/" + versionMatch[2];
+ } else if (versionValue === "") {
+ window.location.pathname = "ditto/" + remainingPath;
+ } else if (versionMatch) {
+ window.location.pathname = "ditto/" + versionValue + "/" + versionMatch[2];
+ } else {
+ window.location.pathname = "ditto/" + versionValue + "/" + remainingPath;
+ }
+ }
+}
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Delete a resource</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+
+
+
+<!-- this handles the automatic toc. use ## for subheads to auto-generate the on-page minitoc. if you use html tags, you must supply an ID for the heading element in order for it to appear in the minitoc. -->
+<script>
+$( document ).ready(function() {
+ // Handler for .ready() called.
+
+$('#toc').toc({ minimumHeaders: 0, listType: 'ul', showSpeed: 0, headers: 'h2,h3,h4' });
+
+/* this offset helps account for the space taken up by the floating toolbar. */
+$('#toc').on('click', 'a', function() {
+ var target = $(this.getAttribute('href'))
+ , scroll_target = target.offset().top
+
+ $(window).scrollTop(scroll_target - 10);
+ return false
+})
+
+});
+</script>
+
+<div id="toc"></div>
+
+
+
+
+
+
+
+
+
+
+<h2 id="deleteresource">DeleteResource</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/the_policy_id/policies/commands/delete"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/entries/the_label/resources/thing:/the_resource_path"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="deleteresourceresponse">DeleteResourceResponse</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/the_policy_id/policies/commands/delete"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/entries/the_label/resources/thing:/the_resource_path"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">204</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+
+
+ <div class="tags">
+
+ </div>
+
+</div>
+
+<hr class="shaded"/>
+
+<footer>
+ <div class="row">
+ <div class="col-lg-12 footer">
+ <div class="logo">
+ <a href="https://eclipse.org"><img src="images/eclipse_foundation_logo.svg" alt="Eclipse logo"/></a>
+ </div>
+ <p class="notice">
+ ©2020 Eclipse Ditto.
+ Site last generated: Jul 1, 2020 <br />
+ </p>
+ <div class="quickLinks">
+ <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
+ > Privacy Policy
+ </a>
+ <a href="https://www.eclipse.org/legal/termsofuse.php" target="_blank">
+ > Terms of Use
+ </a>
+ <a href="https://www.eclipse.org/legal/copyright.php" target="_blank">
+ > Copyright Agent
+ </a>
+ <a href="https://www.eclipse.org/legal" target="_blank">
+ > Legal
+ </a>
+ <a href="https://www.eclipse.org/legal/epl-2.0/" target="_blank">
+ > License
+ </a>
+ <a href="https://eclipse.org/security" target="_blank">
+ > Report a Vulnerability
+ </a>
+ </div>
+ </div>
+ </div>
+</footer>
+
+
+ </div>
+ <!-- /.row -->
+</div>
+<!-- /.container -->
+</div>
+<!-- /#main -->
+ </div>
+
+</body>
+</html>
diff --git a/1.0/protocol-examples-policies-deletesubject.html b/1.0/protocol-examples-policies-deletesubject.html
new file mode 100644
index 0000000..866b1ee
--- /dev/null
+++ b/1.0/protocol-examples-policies-deletesubject.html
@@ -0,0 +1,1550 @@
+<!DOCTYPE html>
+<html>
+<head>
+ <meta charset="utf-8">
+<meta http-equiv="X-UA-Compatible" content="IE=edge">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="description" content="">
+<meta name="keywords" content=" examples, delete subject">
+<title> Delete a subject • Eclipse Ditto • a digital twin framework</title>
+
+<link rel="stylesheet" href="css/syntax.css">
+<link rel="stylesheet" type="text/css" href="//cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/modern-business.css">
+<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/customstyles.css">
+<link rel="stylesheet" href="css/boxshadowproperties.css">
+<link rel="stylesheet" href="css/theme-ditto.css">
+<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:400,700|Source+Code+Pro:300,600|Titillium+Web:400,600,700">
+
+<script src="//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.4/jquery.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/js/bootstrap.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/anchor-js/2.0.0/anchor.min.js" crossorigin="anonymous"></script>
+<script src="js/toc.js"></script>
+<script src="js/customscripts.js"></script>
+
+<script type="application/ld+json">
+{
+ "@context": "http://schema.org",
+ "@type": "Organization",
+ "url": "https://eclipse.org/ditto/",
+ "logo": "https://eclipse.org/ditto/images/ditto.svg"
+}
+</script>
+
+<link rel="icon" type="image/png" href="images/favicon-16x16.png" sizes="16x16">
+<link rel="icon" type="image/png" href="images/favicon-32x32.png" sizes="32x32">
+<link rel="icon" type="image/png" href="images/favicon-96x96.png" sizes="96x96">
+
+<link rel="alternate" type="application/rss+xml" title="Eclipse Ditto Blog" href="https://www.eclipse.org/ditto/feed.xml">
+
+<!-- Eclipse Foundation cookie consent: -->
+<link rel="stylesheet" type="text/css" href="//www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css" />
+<script src="//www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+ <script>
+ $(document).ready(function() {
+ $("#tg-sb-link").click(function() {
+ $("#tg-sb-sidebar").toggle();
+ $("#tg-sb-content").toggleClass('col-md-9');
+ $("#tg-sb-content").toggleClass('col-md-12');
+ $("#tg-sb-icon").toggleClass('fa-toggle-on');
+ $("#tg-sb-icon").toggleClass('fa-toggle-off');
+ });
+ });
+ </script>
+</head>
+
+
+<script>
+ (function(w,d,s,l,i){
+ w[l]=w[l]||[];
+ w[l].push({'gtm.start':
+ new Date().getTime(),event:'gtm.js'});
+ var f=d.getElementsByTagName(s)[0],
+ j=d.createElement(s),
+ dl=l!='dataLayer'?'&l='+l:'';
+ j.async=true;
+ j.src='https://www.googletagmanager.com/gtm.js?id='+i+dl;
+ f.parentNode.insertBefore(j,f);
+ })(window,document,'script','dataLayer','GTM-5WLCZXC');
+</script>
+
+
+
+<body>
+<!-- Navigation -->
+<nav class="navbar navbar-inverse navbar-fixed-top">
+ <div class="container topnavlinks">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-ditto-home" href="index.html"> <img src="images/ditto_allwhite_symbolonly.svg" class="ditto-navbar-symbol" alt="Home"> <img src="images/ditto_allwhite_textonly.svg" class="ditto-navbar-symbol-text" alt="Ditto"></a>
+ </div>
+ <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
+ <ul class="nav navbar-nav navbar-right">
+ <!-- toggle sidebar button -->
+ <!--<li><a id="tg-sb-link" href="#"><i id="tg-sb-icon" class="fa fa-toggle-on"></i> Nav</a></li>-->
+ <!-- entries without drop-downs appear here -->
+
+
+
+
+
+
+
+ <li><a href="blog.html">Blog</a></li>
+
+
+
+ <li><a href="intro-overview.html">Documentation</a></li>
+
+
+
+ <li><a href="http-api-doc.html">HTTP API</a></li>
+
+
+
+ <li><a href="https://ditto.eclipse.org" target="_blank">Sandbox</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">GitHub</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">GitHub examples</a></li>
+
+
+
+ <!-- entries with drop-downs appear here -->
+ <!-- conditional logic to control which topnav appears for the audience defined in the configuration file.-->
+
+
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Links<b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+
+ <li><a href="https://projects.eclipse.org/projects/iot.ditto" target="_blank">Eclipse Ditto Project</a></li>
+
+
+
+ <li><a href="https://www.eclipse.org/forums/index.php/f/364/" target="_blank">Forum</a></li>
+
+
+
+ <li><a href="https://ci.eclipse.org/ditto/" target="_blank">Jenkins</a></li>
+
+
+
+ <li><a href="https://dev.eclipse.org/mhonarc/lists/ditto-dev/" target="_blank">Mailing list archives</a></li>
+
+
+
+ <li><a href="https://gitter.im/eclipse/ditto" target="_blank">Gitter.im chat</a></li>
+
+
+ </ul>
+ </li>
+
+
+
+ <!--comment out this block if you want to hide search-->
+ <li>
+ <!--start search-->
+ <div id="search-demo-container">
+ <input type="text" id="search-input" placeholder="search...">
+ <ul id="results-container"></ul>
+ </div>
+ <script src="//cdnjs.cloudflare.com/ajax/libs/simple-jekyll-search/0.0.9/jekyll-search.js" type="text/javascript"></script>
+ <script type="text/javascript">
+ SimpleJekyllSearch.init({
+ searchInput: document.getElementById('search-input'),
+ resultsContainer: document.getElementById('results-container'),
+ dataSource: 'search.json',
+ searchResultTemplate: '<li><a href="{url}" title="Delete a subject">{title}</a></li>',
+ noResultsText: 'No results found.',
+ limit: 10,
+ fuzzy: true,
+ })
+ </script>
+ <!--end search-->
+ </li>
+ </ul>
+ </div>
+ </div>
+ <!-- /.container -->
+</nav>
+
+<!-- Page Content -->
+<div class="container">
+ <div id="main">
+ <!-- Content Row -->
+ <div class="row">
+
+
+ <!-- Sidebar Column -->
+ <div class="col-md-3" id="tg-sb-sidebar">
+
+
+<ul id="mysidebar" class="nav">
+ <li class="sidebarTitle">
+ <label for="docVersion">Eclipse Ditto version:</label>
+ <div class="select-wrapper">
+ <select id="docVersion" name="docVersion">
+
+ <option value="">development</option>
+
+ <option value="1.0">1.0</option>
+
+ <option value="1.1">1.1</option>
+
+ </select>
+ </div>
+ <div id="dev-warning">
+ <div markdown="span" class="alert alert-warning" role="alert" style="font-size:0.6em"><i class="fa fa-warning"></i> <b>Important:</b> This documentation reflects the latest 'development'. You might want to choose a released version.</div>
+ </div>
+ </li>
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Introduction</a>
+ <ul>
+
+
+
+ <li><a href="intro-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="intro-digitaltwins.html">Digital twins</a></li>
+
+
+
+
+
+
+ <li><a href="intro-hello-world.html">Hello world</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Release Notes</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_100.html">1.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_090.html">0.9.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_080.html">0.8.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Milestone releases</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_100-M2.html">1.0.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_100-M1a.html">1.0.0-M1a</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M2.html">0.9.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M1.html">0.9.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M3.html">0.8.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M2.html">0.8.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M1.html">0.8.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M2.html">0.3.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M1.html">0.3.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_020-M1.html">0.2.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M3.html">0.1.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M1.html">0.1.0-M1</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Installation</a>
+ <ul>
+
+
+
+ <li><a href="installation-building.html">Building Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-running.html">Running Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-operating.html">Operating Ditto</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Basic concepts</a>
+ <ul>
+
+
+
+ <li><a href="basic-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Model entities</a>
+ <ul>
+
+
+
+ <li><a href="basic-thing.html">Thing</a></li>
+
+
+
+
+
+ <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
+
+
+
+
+
+ <li><a href="basic-feature.html">Feature</a></li>
+
+
+
+
+
+ <li><a href="basic-policy.html">Policy</a></li>
+
+
+
+
+
+ <li><a href="basic-namespaces-and-names.html">Namespaces and Names</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-auth.html">Authentication and Authorization</a></li>
+
+
+
+
+
+
+ <li><a href="basic-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="basic-signals.html">Signals</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Signal types</a>
+ <ul>
+
+
+
+ <li><a href="basic-signals-command.html">Command</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-commandresponse.html">Command response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-errorresponse.html">Error response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-event.html">Event</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-apis.html">APIs</a></li>
+
+
+
+
+
+
+ <li><a href="basic-connections.html">Connections</a></li>
+
+
+
+
+
+
+ <li><a href="basic-placeholders.html">Placeholders</a></li>
+
+
+
+
+
+
+ <li><a href="basic-changenotifications.html">Change notifications</a></li>
+
+
+
+
+
+
+ <li><a href="basic-rql.html">RQL expressions</a></li>
+
+
+
+
+
+
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
+ <li><a href="basic-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Architecture</a>
+ <ul>
+
+
+
+ <li><a href="architecture-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Services</a>
+ <ul>
+
+
+
+ <li><a href="architecture-services-policies.html">Policies</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things.html">Things</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things-search.html">Things-Search</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-connectivity.html">Connectivity</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-concierge.html">Concierge</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-gateway.html">Gateway</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>HTTP API</a>
+ <ul>
+
+
+
+ <li><a href="httpapi-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-concepts.html">Concepts</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-protocol-bindings-websocket.html">WebSocket protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-sse.html">Server sent events</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Connectivity API</a>
+ <ul>
+
+
+
+ <li><a href="connectivity-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-manage-connections.html">Manage connections</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp091.html">AMQP 0.9.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp10.html">AMQP 1.0 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-kafka2.html">Kafka 2.x protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-mapping.html">Payload mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-header-mapping.html">Header mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-tls-certificates.html">TLS certificates</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Client SDK</a>
+ <ul>
+
+
+
+ <li><a href="client-sdk-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-java.html">Java</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-javascript.html">JavaScript</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Ditto Protocol</a>
+ <ul>
+
+
+
+ <li><a href="protocol-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-twinlive.html">Twin/live channel</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification.html">Specification</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-topic.html">Protocol topic</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-things.html">Things group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-delete.html">Delete</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ search/messages</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-search.html">Search</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-messages.html">Messages</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-bindings.html">Bindings</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-examples.html">Examples</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-creatething.html">Create a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletething.html">Delete a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifything.html">Modify a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievething.html">Retrieve a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethings.html">Retrieve multiple Things</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattributes.html">Delete Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattributes.html">Modify Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattributes.html">Retrieve Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattribute.html">Create a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattribute.html">Delete a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattribute.html">Modify a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattribute.html">Retrieve a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createthingdefinition.html">Create a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletethingdefinition.html">Delete a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifythingdefinition.html">Modify a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethingdefinition.html">Retrieve a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeatures.html">Create Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeatures.html">Delete Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeatures.html">Modify Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeatures.html">Retrieve Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeature.html">Create a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeature.html">Delete a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeature.html">Modify a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeature.html">Retrieve a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdefinition.html">Create Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedefinition.html">Delete Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydefinition.html">Modify Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedefinition.html">Retrieve Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperties.html">Create Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperties.html">Delete Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperties.html">Modify Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperties.html">Retrieve Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperty.html">Create a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperty.html">Delete a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperty.html">Modify a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperty.html">Retrieve a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li class="active"><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li><a href="sandbox.html">Sandbox</a></li>
+
+
+
+
+
+ <li><a href="presentations.html">Presentations</a></li>
+
+
+
+
+
+ <li><a href="glossary.html">Glossary</a></li>
+
+
+
+
+
+ <li><a href="feedback.html">Feedback</a></li>
+
+
+
+
+
+ <p class="external">
+ <a href="#" id="collapseAll">Collapse All</a> | <a href="#" id="expandAll">Expand All</a>
+ </p>
+
+</ul>
+
+<!-- this highlights the active parent class in the sidebar. this is critical so that the parent expands when you're viewing a page. This must appear below the sidebar code above. Otherwise, if placed inside customscripts.js, the script runs before the sidebar code runs and the class never gets inserted.-->
+<script>$("li.active").parents('li').toggleClass("active");
+
+$(function() {
+ $("#dev-warning").hide();
+ changeSelectedDocVersionDropdownSelection($("#docVersion")[0]);
+ $("#docVersion").change(changeSelectedDocVersion);
+});
+
+function changeSelectedDocVersionDropdownSelection(element) {
+ var pathName = window.location.pathname;
+
+ var versionOptions = element.options;
+ for (var i = 0; i < versionOptions.length; i++) {
+ var versionValue = versionOptions[i].value;
+ if ((versionValue !== "") && pathName.startsWith("/ditto/"+versionValue+"/")) {
+ $("#docVersion").val(versionValue).change();
+ return;
+ }
+ }
+ // fallback: dev with "empty" version value:
+ $("#docVersion").val("").change();
+ $("#dev-warning").show();
+}
+function changeSelectedDocVersion() {
+ var versionValue = $('#docVersion').val();
+ var remainingPath = window.location.pathname.replace("/ditto/", "");
+ var versionMatch = remainingPath.match("([0-9].[0.9])/(.*)");
+ if (versionValue === "" && !versionMatch) {
+ // do nothing, we're already on the correct "dev" version
+ } else if (versionMatch && (versionValue === versionMatch[1])) {
+ // do nothing, we're already on the correct version
+ } else {
+ if (versionValue === "" && versionMatch) {
+ window.location.pathname = "ditto/" + versionMatch[2];
+ } else if (versionValue === "") {
+ window.location.pathname = "ditto/" + remainingPath;
+ } else if (versionMatch) {
+ window.location.pathname = "ditto/" + versionValue + "/" + versionMatch[2];
+ } else {
+ window.location.pathname = "ditto/" + versionValue + "/" + remainingPath;
+ }
+ }
+}
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Delete a subject</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+
+
+
+<!-- this handles the automatic toc. use ## for subheads to auto-generate the on-page minitoc. if you use html tags, you must supply an ID for the heading element in order for it to appear in the minitoc. -->
+<script>
+$( document ).ready(function() {
+ // Handler for .ready() called.
+
+$('#toc').toc({ minimumHeaders: 0, listType: 'ul', showSpeed: 0, headers: 'h2,h3,h4' });
+
+/* this offset helps account for the space taken up by the floating toolbar. */
+$('#toc').on('click', 'a', function() {
+ var target = $(this.getAttribute('href'))
+ , scroll_target = target.offset().top
+
+ $(window).scrollTop(scroll_target - 10);
+ return false
+})
+
+});
+</script>
+
+<div id="toc"></div>
+
+
+
+
+
+
+
+
+
+
+<h2 id="deletesubject">DeleteSubject</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/the_policy_id/policies/commands/delete"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/entries/the_label/subjects/google:the_subjectid"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="deletesubjectresponse">DeleteSubjectResponse</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/the_policy_id/policies/commands/delete"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/entries/the_label/subjects/google:the_subjectid"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">204</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+
+
+ <div class="tags">
+
+ </div>
+
+</div>
+
+<hr class="shaded"/>
+
+<footer>
+ <div class="row">
+ <div class="col-lg-12 footer">
+ <div class="logo">
+ <a href="https://eclipse.org"><img src="images/eclipse_foundation_logo.svg" alt="Eclipse logo"/></a>
+ </div>
+ <p class="notice">
+ ©2020 Eclipse Ditto.
+ Site last generated: Jul 1, 2020 <br />
+ </p>
+ <div class="quickLinks">
+ <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
+ > Privacy Policy
+ </a>
+ <a href="https://www.eclipse.org/legal/termsofuse.php" target="_blank">
+ > Terms of Use
+ </a>
+ <a href="https://www.eclipse.org/legal/copyright.php" target="_blank">
+ > Copyright Agent
+ </a>
+ <a href="https://www.eclipse.org/legal" target="_blank">
+ > Legal
+ </a>
+ <a href="https://www.eclipse.org/legal/epl-2.0/" target="_blank">
+ > License
+ </a>
+ <a href="https://eclipse.org/security" target="_blank">
+ > Report a Vulnerability
+ </a>
+ </div>
+ </div>
+ </div>
+</footer>
+
+
+ </div>
+ <!-- /.row -->
+</div>
+<!-- /.container -->
+</div>
+<!-- /#main -->
+ </div>
+
+</body>
+</html>
diff --git a/1.0/protocol-examples-policies-errorresponses.html b/1.0/protocol-examples-policies-errorresponses.html
new file mode 100644
index 0000000..74d8aa8
--- /dev/null
+++ b/1.0/protocol-examples-policies-errorresponses.html
@@ -0,0 +1,1888 @@
+<!DOCTYPE html>
+<html>
+<head>
+ <meta charset="utf-8">
+<meta http-equiv="X-UA-Compatible" content="IE=edge">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="description" content="">
+<meta name="keywords" content=" examples, policies error responses, error responses">
+<title> Error responses • Eclipse Ditto • a digital twin framework</title>
+
+<link rel="stylesheet" href="css/syntax.css">
+<link rel="stylesheet" type="text/css" href="//cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/modern-business.css">
+<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/customstyles.css">
+<link rel="stylesheet" href="css/boxshadowproperties.css">
+<link rel="stylesheet" href="css/theme-ditto.css">
+<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:400,700|Source+Code+Pro:300,600|Titillium+Web:400,600,700">
+
+<script src="//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.4/jquery.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/js/bootstrap.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/anchor-js/2.0.0/anchor.min.js" crossorigin="anonymous"></script>
+<script src="js/toc.js"></script>
+<script src="js/customscripts.js"></script>
+
+<script type="application/ld+json">
+{
+ "@context": "http://schema.org",
+ "@type": "Organization",
+ "url": "https://eclipse.org/ditto/",
+ "logo": "https://eclipse.org/ditto/images/ditto.svg"
+}
+</script>
+
+<link rel="icon" type="image/png" href="images/favicon-16x16.png" sizes="16x16">
+<link rel="icon" type="image/png" href="images/favicon-32x32.png" sizes="32x32">
+<link rel="icon" type="image/png" href="images/favicon-96x96.png" sizes="96x96">
+
+<link rel="alternate" type="application/rss+xml" title="Eclipse Ditto Blog" href="https://www.eclipse.org/ditto/feed.xml">
+
+<!-- Eclipse Foundation cookie consent: -->
+<link rel="stylesheet" type="text/css" href="//www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css" />
+<script src="//www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+ <script>
+ $(document).ready(function() {
+ $("#tg-sb-link").click(function() {
+ $("#tg-sb-sidebar").toggle();
+ $("#tg-sb-content").toggleClass('col-md-9');
+ $("#tg-sb-content").toggleClass('col-md-12');
+ $("#tg-sb-icon").toggleClass('fa-toggle-on');
+ $("#tg-sb-icon").toggleClass('fa-toggle-off');
+ });
+ });
+ </script>
+</head>
+
+
+<script>
+ (function(w,d,s,l,i){
+ w[l]=w[l]||[];
+ w[l].push({'gtm.start':
+ new Date().getTime(),event:'gtm.js'});
+ var f=d.getElementsByTagName(s)[0],
+ j=d.createElement(s),
+ dl=l!='dataLayer'?'&l='+l:'';
+ j.async=true;
+ j.src='https://www.googletagmanager.com/gtm.js?id='+i+dl;
+ f.parentNode.insertBefore(j,f);
+ })(window,document,'script','dataLayer','GTM-5WLCZXC');
+</script>
+
+
+
+<body>
+<!-- Navigation -->
+<nav class="navbar navbar-inverse navbar-fixed-top">
+ <div class="container topnavlinks">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-ditto-home" href="index.html"> <img src="images/ditto_allwhite_symbolonly.svg" class="ditto-navbar-symbol" alt="Home"> <img src="images/ditto_allwhite_textonly.svg" class="ditto-navbar-symbol-text" alt="Ditto"></a>
+ </div>
+ <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
+ <ul class="nav navbar-nav navbar-right">
+ <!-- toggle sidebar button -->
+ <!--<li><a id="tg-sb-link" href="#"><i id="tg-sb-icon" class="fa fa-toggle-on"></i> Nav</a></li>-->
+ <!-- entries without drop-downs appear here -->
+
+
+
+
+
+
+
+ <li><a href="blog.html">Blog</a></li>
+
+
+
+ <li><a href="intro-overview.html">Documentation</a></li>
+
+
+
+ <li><a href="http-api-doc.html">HTTP API</a></li>
+
+
+
+ <li><a href="https://ditto.eclipse.org" target="_blank">Sandbox</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">GitHub</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">GitHub examples</a></li>
+
+
+
+ <!-- entries with drop-downs appear here -->
+ <!-- conditional logic to control which topnav appears for the audience defined in the configuration file.-->
+
+
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Links<b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+
+ <li><a href="https://projects.eclipse.org/projects/iot.ditto" target="_blank">Eclipse Ditto Project</a></li>
+
+
+
+ <li><a href="https://www.eclipse.org/forums/index.php/f/364/" target="_blank">Forum</a></li>
+
+
+
+ <li><a href="https://ci.eclipse.org/ditto/" target="_blank">Jenkins</a></li>
+
+
+
+ <li><a href="https://dev.eclipse.org/mhonarc/lists/ditto-dev/" target="_blank">Mailing list archives</a></li>
+
+
+
+ <li><a href="https://gitter.im/eclipse/ditto" target="_blank">Gitter.im chat</a></li>
+
+
+ </ul>
+ </li>
+
+
+
+ <!--comment out this block if you want to hide search-->
+ <li>
+ <!--start search-->
+ <div id="search-demo-container">
+ <input type="text" id="search-input" placeholder="search...">
+ <ul id="results-container"></ul>
+ </div>
+ <script src="//cdnjs.cloudflare.com/ajax/libs/simple-jekyll-search/0.0.9/jekyll-search.js" type="text/javascript"></script>
+ <script type="text/javascript">
+ SimpleJekyllSearch.init({
+ searchInput: document.getElementById('search-input'),
+ resultsContainer: document.getElementById('results-container'),
+ dataSource: 'search.json',
+ searchResultTemplate: '<li><a href="{url}" title="Error responses">{title}</a></li>',
+ noResultsText: 'No results found.',
+ limit: 10,
+ fuzzy: true,
+ })
+ </script>
+ <!--end search-->
+ </li>
+ </ul>
+ </div>
+ </div>
+ <!-- /.container -->
+</nav>
+
+<!-- Page Content -->
+<div class="container">
+ <div id="main">
+ <!-- Content Row -->
+ <div class="row">
+
+
+ <!-- Sidebar Column -->
+ <div class="col-md-3" id="tg-sb-sidebar">
+
+
+<ul id="mysidebar" class="nav">
+ <li class="sidebarTitle">
+ <label for="docVersion">Eclipse Ditto version:</label>
+ <div class="select-wrapper">
+ <select id="docVersion" name="docVersion">
+
+ <option value="">development</option>
+
+ <option value="1.0">1.0</option>
+
+ <option value="1.1">1.1</option>
+
+ </select>
+ </div>
+ <div id="dev-warning">
+ <div markdown="span" class="alert alert-warning" role="alert" style="font-size:0.6em"><i class="fa fa-warning"></i> <b>Important:</b> This documentation reflects the latest 'development'. You might want to choose a released version.</div>
+ </div>
+ </li>
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Introduction</a>
+ <ul>
+
+
+
+ <li><a href="intro-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="intro-digitaltwins.html">Digital twins</a></li>
+
+
+
+
+
+
+ <li><a href="intro-hello-world.html">Hello world</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Release Notes</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_100.html">1.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_090.html">0.9.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_080.html">0.8.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Milestone releases</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_100-M2.html">1.0.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_100-M1a.html">1.0.0-M1a</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M2.html">0.9.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M1.html">0.9.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M3.html">0.8.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M2.html">0.8.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M1.html">0.8.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M2.html">0.3.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M1.html">0.3.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_020-M1.html">0.2.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M3.html">0.1.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M1.html">0.1.0-M1</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Installation</a>
+ <ul>
+
+
+
+ <li><a href="installation-building.html">Building Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-running.html">Running Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-operating.html">Operating Ditto</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Basic concepts</a>
+ <ul>
+
+
+
+ <li><a href="basic-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Model entities</a>
+ <ul>
+
+
+
+ <li><a href="basic-thing.html">Thing</a></li>
+
+
+
+
+
+ <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
+
+
+
+
+
+ <li><a href="basic-feature.html">Feature</a></li>
+
+
+
+
+
+ <li><a href="basic-policy.html">Policy</a></li>
+
+
+
+
+
+ <li><a href="basic-namespaces-and-names.html">Namespaces and Names</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-auth.html">Authentication and Authorization</a></li>
+
+
+
+
+
+
+ <li><a href="basic-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="basic-signals.html">Signals</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Signal types</a>
+ <ul>
+
+
+
+ <li><a href="basic-signals-command.html">Command</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-commandresponse.html">Command response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-errorresponse.html">Error response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-event.html">Event</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-apis.html">APIs</a></li>
+
+
+
+
+
+
+ <li><a href="basic-connections.html">Connections</a></li>
+
+
+
+
+
+
+ <li><a href="basic-placeholders.html">Placeholders</a></li>
+
+
+
+
+
+
+ <li><a href="basic-changenotifications.html">Change notifications</a></li>
+
+
+
+
+
+
+ <li><a href="basic-rql.html">RQL expressions</a></li>
+
+
+
+
+
+
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
+ <li><a href="basic-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Architecture</a>
+ <ul>
+
+
+
+ <li><a href="architecture-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Services</a>
+ <ul>
+
+
+
+ <li><a href="architecture-services-policies.html">Policies</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things.html">Things</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things-search.html">Things-Search</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-connectivity.html">Connectivity</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-concierge.html">Concierge</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-gateway.html">Gateway</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>HTTP API</a>
+ <ul>
+
+
+
+ <li><a href="httpapi-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-concepts.html">Concepts</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-protocol-bindings-websocket.html">WebSocket protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-sse.html">Server sent events</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Connectivity API</a>
+ <ul>
+
+
+
+ <li><a href="connectivity-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-manage-connections.html">Manage connections</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp091.html">AMQP 0.9.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp10.html">AMQP 1.0 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-kafka2.html">Kafka 2.x protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-mapping.html">Payload mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-header-mapping.html">Header mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-tls-certificates.html">TLS certificates</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Client SDK</a>
+ <ul>
+
+
+
+ <li><a href="client-sdk-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-java.html">Java</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-javascript.html">JavaScript</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Ditto Protocol</a>
+ <ul>
+
+
+
+ <li><a href="protocol-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-twinlive.html">Twin/live channel</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification.html">Specification</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-topic.html">Protocol topic</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-things.html">Things group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-delete.html">Delete</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ search/messages</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-search.html">Search</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-messages.html">Messages</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-bindings.html">Bindings</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-examples.html">Examples</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-creatething.html">Create a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletething.html">Delete a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifything.html">Modify a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievething.html">Retrieve a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethings.html">Retrieve multiple Things</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattributes.html">Delete Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattributes.html">Modify Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattributes.html">Retrieve Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattribute.html">Create a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattribute.html">Delete a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattribute.html">Modify a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattribute.html">Retrieve a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createthingdefinition.html">Create a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletethingdefinition.html">Delete a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifythingdefinition.html">Modify a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethingdefinition.html">Retrieve a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeatures.html">Create Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeatures.html">Delete Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeatures.html">Modify Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeatures.html">Retrieve Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeature.html">Create a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeature.html">Delete a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeature.html">Modify a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeature.html">Retrieve a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdefinition.html">Create Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedefinition.html">Delete Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydefinition.html">Modify Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedefinition.html">Retrieve Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperties.html">Create Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperties.html">Delete Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperties.html">Modify Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperties.html">Retrieve Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperty.html">Create a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperty.html">Delete a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperty.html">Modify a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperty.html">Retrieve a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li class="active"><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li><a href="sandbox.html">Sandbox</a></li>
+
+
+
+
+
+ <li><a href="presentations.html">Presentations</a></li>
+
+
+
+
+
+ <li><a href="glossary.html">Glossary</a></li>
+
+
+
+
+
+ <li><a href="feedback.html">Feedback</a></li>
+
+
+
+
+
+ <p class="external">
+ <a href="#" id="collapseAll">Collapse All</a> | <a href="#" id="expandAll">Expand All</a>
+ </p>
+
+</ul>
+
+<!-- this highlights the active parent class in the sidebar. this is critical so that the parent expands when you're viewing a page. This must appear below the sidebar code above. Otherwise, if placed inside customscripts.js, the script runs before the sidebar code runs and the class never gets inserted.-->
+<script>$("li.active").parents('li').toggleClass("active");
+
+$(function() {
+ $("#dev-warning").hide();
+ changeSelectedDocVersionDropdownSelection($("#docVersion")[0]);
+ $("#docVersion").change(changeSelectedDocVersion);
+});
+
+function changeSelectedDocVersionDropdownSelection(element) {
+ var pathName = window.location.pathname;
+
+ var versionOptions = element.options;
+ for (var i = 0; i < versionOptions.length; i++) {
+ var versionValue = versionOptions[i].value;
+ if ((versionValue !== "") && pathName.startsWith("/ditto/"+versionValue+"/")) {
+ $("#docVersion").val(versionValue).change();
+ return;
+ }
+ }
+ // fallback: dev with "empty" version value:
+ $("#docVersion").val("").change();
+ $("#dev-warning").show();
+}
+function changeSelectedDocVersion() {
+ var versionValue = $('#docVersion').val();
+ var remainingPath = window.location.pathname.replace("/ditto/", "");
+ var versionMatch = remainingPath.match("([0-9].[0.9])/(.*)");
+ if (versionValue === "" && !versionMatch) {
+ // do nothing, we're already on the correct "dev" version
+ } else if (versionMatch && (versionValue === versionMatch[1])) {
+ // do nothing, we're already on the correct version
+ } else {
+ if (versionValue === "" && versionMatch) {
+ window.location.pathname = "ditto/" + versionMatch[2];
+ } else if (versionValue === "") {
+ window.location.pathname = "ditto/" + remainingPath;
+ } else if (versionMatch) {
+ window.location.pathname = "ditto/" + versionValue + "/" + versionMatch[2];
+ } else {
+ window.location.pathname = "ditto/" + versionValue + "/" + remainingPath;
+ }
+ }
+}
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Error responses</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+
+
+
+<!-- this handles the automatic toc. use ## for subheads to auto-generate the on-page minitoc. if you use html tags, you must supply an ID for the heading element in order for it to appear in the minitoc. -->
+<script>
+$( document ).ready(function() {
+ // Handler for .ready() called.
+
+$('#toc').toc({ minimumHeaders: 0, listType: 'ul', showSpeed: 0, headers: 'h2,h3,h4' });
+
+/* this offset helps account for the space taken up by the floating toolbar. */
+$('#toc').on('click', 'a', function() {
+ var target = $(this.getAttribute('href'))
+ , scroll_target = target.offset().top
+
+ $(window).scrollTop(scroll_target - 10);
+ return false
+})
+
+});
+</script>
+
+<div id="toc"></div>
+
+
+
+
+
+
+
+
+
+
+<h2 id="policiesidinvalid">policies:id.invalid</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"unknown/unknown/policies/errors"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">400</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"error"</span><span class="p">:</span><span class="w"> </span><span class="s2">"policies:id.invalid"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"message"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Policy ID 'invalid id' is not valid!"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"description"</span><span class="p">:</span><span class="w"> </span><span class="s2">"It must conform to the namespaced entity ID notation (see Ditto documentation)"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"href"</span><span class="p">:</span><span class="w"> </span><span class="s2">"https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">400</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="policiespolicyconflict">policies:policy.conflict</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"unknown/unknown/policies/errors"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">409</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"error"</span><span class="p">:</span><span class="w"> </span><span class="s2">"policies:policy.conflict"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"message"</span><span class="p">:</span><span class="w"> </span><span class="s2">"The Policy with ID 'com.acme:the_policy_id' already exists"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"description"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Choose another Policy ID"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">409</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="policiespolicymodificationinvalid">policies:policy.modificationinvalid</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"unknown/unknown/policies/errors"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">403</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"error"</span><span class="p">:</span><span class="w"> </span><span class="s2">"policies:policy.modificationinvalid"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"message"</span><span class="p">:</span><span class="w"> </span><span class="s2">"The Policy with ID 'com.acme:the_policy_id' could not be modified as the resulting Policy would be invalid."</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"description"</span><span class="p">:</span><span class="w"> </span><span class="s2">"There must always be at least one PolicyEntry with 'WRITE' permissions on resource 'policy:/'."</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">403</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="policiespolicynotfound">policies:policy.notfound</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"unknown/unknown/policies/errors"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">404</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"error"</span><span class="p">:</span><span class="w"> </span><span class="s2">"policies:policy.notfound"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"message"</span><span class="p">:</span><span class="w"> </span><span class="s2">"The Policy with ID 'com.acme:the_policy_id' could not be found or requester had insufficient permissions to access it."</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"description"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Check if the ID of your requested Policy was correct and you have sufficient permissions."</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">404</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="policiespolicynotmodifiable">policies:policy.notmodifiable</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"unknown/unknown/policies/errors"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">403</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"error"</span><span class="p">:</span><span class="w"> </span><span class="s2">"policies:policy.notmodifiable"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"message"</span><span class="p">:</span><span class="w"> </span><span class="s2">"The Policy with ID 'com.acme:the_policy_id' could not be modified as the requester had insufficient permissions."</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"description"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Check if the ID of your requested Policy was correct and you have sufficient permissions."</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">403</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="policiespolicytoomanymodifyingrequests">policies:policy.toomanymodifyingrequests</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"unknown/unknown/policies/errors"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">429</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"error"</span><span class="p">:</span><span class="w"> </span><span class="s2">"policies:policy.toomanymodifyingrequests"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"message"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Too many modifying requests are already outstanding to the Policy with ID 'com.acme:the_policy_id'."</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"description"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Throttle your modifying requests to the Policy or re-structure your Policy in multiple Policies if you really need so many concurrent modifications."</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">429</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="policiespolicyunavailable">policies:policy.unavailable</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"unknown/unknown/policies/errors"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">503</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"error"</span><span class="p">:</span><span class="w"> </span><span class="s2">"policies:policy.unavailable"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"message"</span><span class="p">:</span><span class="w"> </span><span class="s2">"The Policy with ID 'com.acme:the_policy_id' is not available, please try again later."</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"description"</span><span class="p">:</span><span class="w"> </span><span class="s2">"The requested Policy is temporarily not available."</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">503</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="policiesentryinvalid">policies:entry.invalid</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"unknown/unknown/policies/errors"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">400</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"error"</span><span class="p">:</span><span class="w"> </span><span class="s2">"policies:entry.invalid"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"message"</span><span class="p">:</span><span class="w"> </span><span class="s2">"The Policy Entry is invalid."</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"description"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Policy entry does not contain any known permission like 'READ' or 'WRITE'"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">400</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="policiesentrymodificationinvalid">policies:entry.modificationinvalid</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"unknown/unknown/policies/errors"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">403</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"error"</span><span class="p">:</span><span class="w"> </span><span class="s2">"policies:entry.modificationinvalid"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"message"</span><span class="p">:</span><span class="w"> </span><span class="s2">"The PolicyEntry with Label 'the_label' on the Policy with ID 'com.acme:the_policy_id' could not be modified as the resulting Policy would be invalid."</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"description"</span><span class="p">:</span><span class="w"> </span><span class="s2">"There must always be at least one PolicyEntry with 'WRITE' permissions on resource 'policy:/'."</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">403</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="policiesentrynotfound">policies:entry.notfound</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"unknown/unknown/policies/errors"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">404</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"error"</span><span class="p">:</span><span class="w"> </span><span class="s2">"policies:entry.notfound"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"message"</span><span class="p">:</span><span class="w"> </span><span class="s2">"The PolicyEntry with Label 'the_label' on the Policy with ID 'com.acme:the_policy_id' could not be found or requester had insufficient permissions to access it."</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"description"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Check if the ID of the Policy and the Label of your requested PolicyEntry was correct and you have sufficient permissions."</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">404</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="policiesentrynotmodifiable">policies:entry.notmodifiable</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"unknown/unknown/policies/errors"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">403</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"error"</span><span class="p">:</span><span class="w"> </span><span class="s2">"policies:entry.notmodifiable"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"message"</span><span class="p">:</span><span class="w"> </span><span class="s2">"The PolicyEntry with Label 'the_label' on the Policy with ID 'com.acme:the_policy_id' could not be modified as the requester had insufficient permissions."</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"description"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Check if the ID of the Policy and the Label of your requested PolicyEntry was correct and you have sufficient permissions."</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">403</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="policiessubjectsnotfound">policies:subjects.notfound</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"unknown/unknown/policies/errors"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">404</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"error"</span><span class="p">:</span><span class="w"> </span><span class="s2">"policies:subjects.notfound"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"message"</span><span class="p">:</span><span class="w"> </span><span class="s2">"The Subjects of the PolicyEntry with Label 'the_label' on the Policy with ID 'com.acme:the_policy_id' could not be found or requester had insufficient permissions to access it."</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"description"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Check if the ID of the Policy and the Label of the PolicyEntry was correct and you have sufficient permissions."</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">404</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="policiessubjectsnotmodifiable">policies:subjects.notmodifiable</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"unknown/unknown/policies/errors"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">403</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"error"</span><span class="p">:</span><span class="w"> </span><span class="s2">"policies:subjects.notmodifiable"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"message"</span><span class="p">:</span><span class="w"> </span><span class="s2">"The Subjects of the PolicyEntry with Label 'the_label' on the Policy with ID 'com.acme:the_policy_id' could not be modified as the requester had insufficient permissions."</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"description"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Check if the ID of the Policy and the PolicyEntry's Label of your requested Subjects was correct and you have sufficient permissions."</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">403</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="policiessubjectnotfound">policies:subject.notfound</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"unknown/unknown/policies/errors"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">404</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"error"</span><span class="p">:</span><span class="w"> </span><span class="s2">"policies:subject.notfound"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"message"</span><span class="p">:</span><span class="w"> </span><span class="s2">"The Subject with ID 'google:the_subjectid' of the PolicyEntry with Label 'the_label' on the Policy with ID 'com.acme:the_policy_id' could not be found or requester had insufficient permissions to access it."</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"description"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Check if the ID of the Policy, the Label of the PolicyEntry and ID of your requested Subject was correct and you have sufficient permissions."</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">404</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="policiessubjectnotmodifiable">policies:subject.notmodifiable</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"unknown/unknown/policies/errors"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">403</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"error"</span><span class="p">:</span><span class="w"> </span><span class="s2">"policies:subject.notmodifiable"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"message"</span><span class="p">:</span><span class="w"> </span><span class="s2">"The Subject with ID 'google:the_subjectid' of the PolicyEntry with Label 'the_label' on the Policy with ID 'com.acme:the_policy_id' could not be modified as the requester had insufficient permissions."</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"description"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Check if the ID of the Policy, the Label of the PolicyEntry and ID of your requested Subject was correct and you have sufficient permissions."</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">403</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="policiessubjectidinvalid">policies:subjectid.invalid</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"unknown/unknown/policies/errors"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">400</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"error"</span><span class="p">:</span><span class="w"> </span><span class="s2">"policies:subjectid.invalid"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"message"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Subject ID 'invalid subject' is not valid!"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"description"</span><span class="p">:</span><span class="w"> </span><span class="s2">"It must contain an issuer as prefix separated by a colon ':' from the actual subject"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">400</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="policiesresourcesnotfound">policies:resources.notfound</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"unknown/unknown/policies/errors"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">404</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"error"</span><span class="p">:</span><span class="w"> </span><span class="s2">"policies:resources.notfound"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"message"</span><span class="p">:</span><span class="w"> </span><span class="s2">"The Resources of the PolicyEntry with Label 'the_label' on the Policy with ID 'com.acme:the_policy_id' could not be found or requester had insufficient permissions to access it."</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"description"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Check if the ID of the Policy and the Label of the PolicyEntry was correct and you have sufficient permissions."</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">404</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="policiesresourcesnotmodifiable">policies:resources.notmodifiable</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"unknown/unknown/policies/errors"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">403</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"error"</span><span class="p">:</span><span class="w"> </span><span class="s2">"policies:resources.notmodifiable"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"message"</span><span class="p">:</span><span class="w"> </span><span class="s2">"The Resources of the PolicyEntry with Label 'the_label' on the Policy with ID 'com.acme:the_policy_id' could not be modified as the requester had insufficient permissions."</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"description"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Check if the ID of the Policy and the PolicyEntry's Label of your requested Resources was correct and you have sufficient permissions."</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">403</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="policiesresourcenotfound">policies:resource.notfound</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"unknown/unknown/policies/errors"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">404</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"error"</span><span class="p">:</span><span class="w"> </span><span class="s2">"policies:resource.notfound"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"message"</span><span class="p">:</span><span class="w"> </span><span class="s2">"The Resource '/the_resource_path' of the PolicyEntry with Label 'the_label' on the Policy with ID 'com.acme:the_policy_id' could not be found or requester had insufficient permissions to access it."</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"description"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Check if the ID of the Policy, the Label of the PolicyEntry and the path of your requested Resource was correct and you have sufficient permissions."</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">404</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="policiesresourcenotmodifiable">policies:resource.notmodifiable</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"unknown/unknown/policies/errors"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">403</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"error"</span><span class="p">:</span><span class="w"> </span><span class="s2">"policies:resource.notmodifiable"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"message"</span><span class="p">:</span><span class="w"> </span><span class="s2">"The Resource '/the_resource_path' of the PolicyEntry with Label 'the_label' on the Policy with ID 'com.acme:the_policy_id' could not be modified as the requester had insufficient permissions."</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"description"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Check if the ID of the Policy, the Label of the PolicyEntry and the path of your requested Resource was correct and you have sufficient permissions."</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">403</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+
+
+ <div class="tags">
+
+ </div>
+
+</div>
+
+<hr class="shaded"/>
+
+<footer>
+ <div class="row">
+ <div class="col-lg-12 footer">
+ <div class="logo">
+ <a href="https://eclipse.org"><img src="images/eclipse_foundation_logo.svg" alt="Eclipse logo"/></a>
+ </div>
+ <p class="notice">
+ ©2020 Eclipse Ditto.
+ Site last generated: Jul 1, 2020 <br />
+ </p>
+ <div class="quickLinks">
+ <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
+ > Privacy Policy
+ </a>
+ <a href="https://www.eclipse.org/legal/termsofuse.php" target="_blank">
+ > Terms of Use
+ </a>
+ <a href="https://www.eclipse.org/legal/copyright.php" target="_blank">
+ > Copyright Agent
+ </a>
+ <a href="https://www.eclipse.org/legal" target="_blank">
+ > Legal
+ </a>
+ <a href="https://www.eclipse.org/legal/epl-2.0/" target="_blank">
+ > License
+ </a>
+ <a href="https://eclipse.org/security" target="_blank">
+ > Report a Vulnerability
+ </a>
+ </div>
+ </div>
+ </div>
+</footer>
+
+
+ </div>
+ <!-- /.row -->
+</div>
+<!-- /.container -->
+</div>
+<!-- /#main -->
+ </div>
+
+</body>
+</html>
diff --git a/1.0/protocol-examples-policies-modifypolicy.html b/1.0/protocol-examples-policies-modifypolicy.html
new file mode 100644
index 0000000..5a5bf8c
--- /dev/null
+++ b/1.0/protocol-examples-policies-modifypolicy.html
@@ -0,0 +1,1571 @@
+<!DOCTYPE html>
+<html>
+<head>
+ <meta charset="utf-8">
+<meta http-equiv="X-UA-Compatible" content="IE=edge">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="description" content="">
+<meta name="keywords" content=" examples, modify policy">
+<title> Modify a Policy • Eclipse Ditto • a digital twin framework</title>
+
+<link rel="stylesheet" href="css/syntax.css">
+<link rel="stylesheet" type="text/css" href="//cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/modern-business.css">
+<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/customstyles.css">
+<link rel="stylesheet" href="css/boxshadowproperties.css">
+<link rel="stylesheet" href="css/theme-ditto.css">
+<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:400,700|Source+Code+Pro:300,600|Titillium+Web:400,600,700">
+
+<script src="//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.4/jquery.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/js/bootstrap.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/anchor-js/2.0.0/anchor.min.js" crossorigin="anonymous"></script>
+<script src="js/toc.js"></script>
+<script src="js/customscripts.js"></script>
+
+<script type="application/ld+json">
+{
+ "@context": "http://schema.org",
+ "@type": "Organization",
+ "url": "https://eclipse.org/ditto/",
+ "logo": "https://eclipse.org/ditto/images/ditto.svg"
+}
+</script>
+
+<link rel="icon" type="image/png" href="images/favicon-16x16.png" sizes="16x16">
+<link rel="icon" type="image/png" href="images/favicon-32x32.png" sizes="32x32">
+<link rel="icon" type="image/png" href="images/favicon-96x96.png" sizes="96x96">
+
+<link rel="alternate" type="application/rss+xml" title="Eclipse Ditto Blog" href="https://www.eclipse.org/ditto/feed.xml">
+
+<!-- Eclipse Foundation cookie consent: -->
+<link rel="stylesheet" type="text/css" href="//www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css" />
+<script src="//www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+ <script>
+ $(document).ready(function() {
+ $("#tg-sb-link").click(function() {
+ $("#tg-sb-sidebar").toggle();
+ $("#tg-sb-content").toggleClass('col-md-9');
+ $("#tg-sb-content").toggleClass('col-md-12');
+ $("#tg-sb-icon").toggleClass('fa-toggle-on');
+ $("#tg-sb-icon").toggleClass('fa-toggle-off');
+ });
+ });
+ </script>
+</head>
+
+
+<script>
+ (function(w,d,s,l,i){
+ w[l]=w[l]||[];
+ w[l].push({'gtm.start':
+ new Date().getTime(),event:'gtm.js'});
+ var f=d.getElementsByTagName(s)[0],
+ j=d.createElement(s),
+ dl=l!='dataLayer'?'&l='+l:'';
+ j.async=true;
+ j.src='https://www.googletagmanager.com/gtm.js?id='+i+dl;
+ f.parentNode.insertBefore(j,f);
+ })(window,document,'script','dataLayer','GTM-5WLCZXC');
+</script>
+
+
+
+<body>
+<!-- Navigation -->
+<nav class="navbar navbar-inverse navbar-fixed-top">
+ <div class="container topnavlinks">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-ditto-home" href="index.html"> <img src="images/ditto_allwhite_symbolonly.svg" class="ditto-navbar-symbol" alt="Home"> <img src="images/ditto_allwhite_textonly.svg" class="ditto-navbar-symbol-text" alt="Ditto"></a>
+ </div>
+ <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
+ <ul class="nav navbar-nav navbar-right">
+ <!-- toggle sidebar button -->
+ <!--<li><a id="tg-sb-link" href="#"><i id="tg-sb-icon" class="fa fa-toggle-on"></i> Nav</a></li>-->
+ <!-- entries without drop-downs appear here -->
+
+
+
+
+
+
+
+ <li><a href="blog.html">Blog</a></li>
+
+
+
+ <li><a href="intro-overview.html">Documentation</a></li>
+
+
+
+ <li><a href="http-api-doc.html">HTTP API</a></li>
+
+
+
+ <li><a href="https://ditto.eclipse.org" target="_blank">Sandbox</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">GitHub</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">GitHub examples</a></li>
+
+
+
+ <!-- entries with drop-downs appear here -->
+ <!-- conditional logic to control which topnav appears for the audience defined in the configuration file.-->
+
+
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Links<b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+
+ <li><a href="https://projects.eclipse.org/projects/iot.ditto" target="_blank">Eclipse Ditto Project</a></li>
+
+
+
+ <li><a href="https://www.eclipse.org/forums/index.php/f/364/" target="_blank">Forum</a></li>
+
+
+
+ <li><a href="https://ci.eclipse.org/ditto/" target="_blank">Jenkins</a></li>
+
+
+
+ <li><a href="https://dev.eclipse.org/mhonarc/lists/ditto-dev/" target="_blank">Mailing list archives</a></li>
+
+
+
+ <li><a href="https://gitter.im/eclipse/ditto" target="_blank">Gitter.im chat</a></li>
+
+
+ </ul>
+ </li>
+
+
+
+ <!--comment out this block if you want to hide search-->
+ <li>
+ <!--start search-->
+ <div id="search-demo-container">
+ <input type="text" id="search-input" placeholder="search...">
+ <ul id="results-container"></ul>
+ </div>
+ <script src="//cdnjs.cloudflare.com/ajax/libs/simple-jekyll-search/0.0.9/jekyll-search.js" type="text/javascript"></script>
+ <script type="text/javascript">
+ SimpleJekyllSearch.init({
+ searchInput: document.getElementById('search-input'),
+ resultsContainer: document.getElementById('results-container'),
+ dataSource: 'search.json',
+ searchResultTemplate: '<li><a href="{url}" title="Modify a Policy">{title}</a></li>',
+ noResultsText: 'No results found.',
+ limit: 10,
+ fuzzy: true,
+ })
+ </script>
+ <!--end search-->
+ </li>
+ </ul>
+ </div>
+ </div>
+ <!-- /.container -->
+</nav>
+
+<!-- Page Content -->
+<div class="container">
+ <div id="main">
+ <!-- Content Row -->
+ <div class="row">
+
+
+ <!-- Sidebar Column -->
+ <div class="col-md-3" id="tg-sb-sidebar">
+
+
+<ul id="mysidebar" class="nav">
+ <li class="sidebarTitle">
+ <label for="docVersion">Eclipse Ditto version:</label>
+ <div class="select-wrapper">
+ <select id="docVersion" name="docVersion">
+
+ <option value="">development</option>
+
+ <option value="1.0">1.0</option>
+
+ <option value="1.1">1.1</option>
+
+ </select>
+ </div>
+ <div id="dev-warning">
+ <div markdown="span" class="alert alert-warning" role="alert" style="font-size:0.6em"><i class="fa fa-warning"></i> <b>Important:</b> This documentation reflects the latest 'development'. You might want to choose a released version.</div>
+ </div>
+ </li>
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Introduction</a>
+ <ul>
+
+
+
+ <li><a href="intro-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="intro-digitaltwins.html">Digital twins</a></li>
+
+
+
+
+
+
+ <li><a href="intro-hello-world.html">Hello world</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Release Notes</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_100.html">1.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_090.html">0.9.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_080.html">0.8.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Milestone releases</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_100-M2.html">1.0.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_100-M1a.html">1.0.0-M1a</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M2.html">0.9.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M1.html">0.9.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M3.html">0.8.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M2.html">0.8.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M1.html">0.8.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M2.html">0.3.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M1.html">0.3.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_020-M1.html">0.2.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M3.html">0.1.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M1.html">0.1.0-M1</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Installation</a>
+ <ul>
+
+
+
+ <li><a href="installation-building.html">Building Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-running.html">Running Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-operating.html">Operating Ditto</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Basic concepts</a>
+ <ul>
+
+
+
+ <li><a href="basic-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Model entities</a>
+ <ul>
+
+
+
+ <li><a href="basic-thing.html">Thing</a></li>
+
+
+
+
+
+ <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
+
+
+
+
+
+ <li><a href="basic-feature.html">Feature</a></li>
+
+
+
+
+
+ <li><a href="basic-policy.html">Policy</a></li>
+
+
+
+
+
+ <li><a href="basic-namespaces-and-names.html">Namespaces and Names</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-auth.html">Authentication and Authorization</a></li>
+
+
+
+
+
+
+ <li><a href="basic-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="basic-signals.html">Signals</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Signal types</a>
+ <ul>
+
+
+
+ <li><a href="basic-signals-command.html">Command</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-commandresponse.html">Command response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-errorresponse.html">Error response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-event.html">Event</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-apis.html">APIs</a></li>
+
+
+
+
+
+
+ <li><a href="basic-connections.html">Connections</a></li>
+
+
+
+
+
+
+ <li><a href="basic-placeholders.html">Placeholders</a></li>
+
+
+
+
+
+
+ <li><a href="basic-changenotifications.html">Change notifications</a></li>
+
+
+
+
+
+
+ <li><a href="basic-rql.html">RQL expressions</a></li>
+
+
+
+
+
+
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
+ <li><a href="basic-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Architecture</a>
+ <ul>
+
+
+
+ <li><a href="architecture-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Services</a>
+ <ul>
+
+
+
+ <li><a href="architecture-services-policies.html">Policies</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things.html">Things</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things-search.html">Things-Search</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-connectivity.html">Connectivity</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-concierge.html">Concierge</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-gateway.html">Gateway</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>HTTP API</a>
+ <ul>
+
+
+
+ <li><a href="httpapi-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-concepts.html">Concepts</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-protocol-bindings-websocket.html">WebSocket protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-sse.html">Server sent events</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Connectivity API</a>
+ <ul>
+
+
+
+ <li><a href="connectivity-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-manage-connections.html">Manage connections</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp091.html">AMQP 0.9.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp10.html">AMQP 1.0 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-kafka2.html">Kafka 2.x protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-mapping.html">Payload mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-header-mapping.html">Header mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-tls-certificates.html">TLS certificates</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Client SDK</a>
+ <ul>
+
+
+
+ <li><a href="client-sdk-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-java.html">Java</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-javascript.html">JavaScript</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Ditto Protocol</a>
+ <ul>
+
+
+
+ <li><a href="protocol-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-twinlive.html">Twin/live channel</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification.html">Specification</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-topic.html">Protocol topic</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-things.html">Things group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-delete.html">Delete</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ search/messages</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-search.html">Search</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-messages.html">Messages</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-bindings.html">Bindings</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-examples.html">Examples</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-creatething.html">Create a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletething.html">Delete a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifything.html">Modify a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievething.html">Retrieve a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethings.html">Retrieve multiple Things</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattributes.html">Delete Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattributes.html">Modify Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattributes.html">Retrieve Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattribute.html">Create a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattribute.html">Delete a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattribute.html">Modify a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattribute.html">Retrieve a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createthingdefinition.html">Create a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletethingdefinition.html">Delete a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifythingdefinition.html">Modify a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethingdefinition.html">Retrieve a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeatures.html">Create Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeatures.html">Delete Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeatures.html">Modify Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeatures.html">Retrieve Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeature.html">Create a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeature.html">Delete a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeature.html">Modify a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeature.html">Retrieve a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdefinition.html">Create Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedefinition.html">Delete Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydefinition.html">Modify Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedefinition.html">Retrieve Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperties.html">Create Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperties.html">Delete Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperties.html">Modify Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperties.html">Retrieve Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperty.html">Create a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperty.html">Delete a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperty.html">Modify a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperty.html">Retrieve a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li class="active"><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li><a href="sandbox.html">Sandbox</a></li>
+
+
+
+
+
+ <li><a href="presentations.html">Presentations</a></li>
+
+
+
+
+
+ <li><a href="glossary.html">Glossary</a></li>
+
+
+
+
+
+ <li><a href="feedback.html">Feedback</a></li>
+
+
+
+
+
+ <p class="external">
+ <a href="#" id="collapseAll">Collapse All</a> | <a href="#" id="expandAll">Expand All</a>
+ </p>
+
+</ul>
+
+<!-- this highlights the active parent class in the sidebar. this is critical so that the parent expands when you're viewing a page. This must appear below the sidebar code above. Otherwise, if placed inside customscripts.js, the script runs before the sidebar code runs and the class never gets inserted.-->
+<script>$("li.active").parents('li').toggleClass("active");
+
+$(function() {
+ $("#dev-warning").hide();
+ changeSelectedDocVersionDropdownSelection($("#docVersion")[0]);
+ $("#docVersion").change(changeSelectedDocVersion);
+});
+
+function changeSelectedDocVersionDropdownSelection(element) {
+ var pathName = window.location.pathname;
+
+ var versionOptions = element.options;
+ for (var i = 0; i < versionOptions.length; i++) {
+ var versionValue = versionOptions[i].value;
+ if ((versionValue !== "") && pathName.startsWith("/ditto/"+versionValue+"/")) {
+ $("#docVersion").val(versionValue).change();
+ return;
+ }
+ }
+ // fallback: dev with "empty" version value:
+ $("#docVersion").val("").change();
+ $("#dev-warning").show();
+}
+function changeSelectedDocVersion() {
+ var versionValue = $('#docVersion').val();
+ var remainingPath = window.location.pathname.replace("/ditto/", "");
+ var versionMatch = remainingPath.match("([0-9].[0.9])/(.*)");
+ if (versionValue === "" && !versionMatch) {
+ // do nothing, we're already on the correct "dev" version
+ } else if (versionMatch && (versionValue === versionMatch[1])) {
+ // do nothing, we're already on the correct version
+ } else {
+ if (versionValue === "" && versionMatch) {
+ window.location.pathname = "ditto/" + versionMatch[2];
+ } else if (versionValue === "") {
+ window.location.pathname = "ditto/" + remainingPath;
+ } else if (versionMatch) {
+ window.location.pathname = "ditto/" + versionValue + "/" + versionMatch[2];
+ } else {
+ window.location.pathname = "ditto/" + versionValue + "/" + remainingPath;
+ }
+ }
+}
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Modify a Policy</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+
+
+
+<!-- this handles the automatic toc. use ## for subheads to auto-generate the on-page minitoc. if you use html tags, you must supply an ID for the heading element in order for it to appear in the minitoc. -->
+<script>
+$( document ).ready(function() {
+ // Handler for .ready() called.
+
+$('#toc').toc({ minimumHeaders: 0, listType: 'ul', showSpeed: 0, headers: 'h2,h3,h4' });
+
+/* this offset helps account for the space taken up by the floating toolbar. */
+$('#toc').on('click', 'a', function() {
+ var target = $(this.getAttribute('href'))
+ , scroll_target = target.offset().top
+
+ $(window).scrollTop(scroll_target - 10);
+ return false
+})
+
+});
+</script>
+
+<div id="toc"></div>
+
+
+
+
+
+
+
+
+
+
+<h2 id="modifypolicy">ModifyPolicy</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/the_policy_id/policies/commands/modify"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"policyId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme:the_policy_id"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"entries"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"the_label"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"subjects"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"google:the_subjectid"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"yourSubjectTypeDescription"</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"resources"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"thing:/the_resource_path"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"grant"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
+ </span><span class="s2">"READ"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"WRITE"</span><span class="w">
+ </span><span class="p">],</span><span class="w">
+ </span><span class="s2">"revoke"</span><span class="p">:</span><span class="w"> </span><span class="p">[]</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="modifypolicyresponse">ModifyPolicyResponse</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/the_policy_id/policies/commands/modify"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">204</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+
+
+ <div class="tags">
+
+ </div>
+
+</div>
+
+<hr class="shaded"/>
+
+<footer>
+ <div class="row">
+ <div class="col-lg-12 footer">
+ <div class="logo">
+ <a href="https://eclipse.org"><img src="images/eclipse_foundation_logo.svg" alt="Eclipse logo"/></a>
+ </div>
+ <p class="notice">
+ ©2020 Eclipse Ditto.
+ Site last generated: Jul 1, 2020 <br />
+ </p>
+ <div class="quickLinks">
+ <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
+ > Privacy Policy
+ </a>
+ <a href="https://www.eclipse.org/legal/termsofuse.php" target="_blank">
+ > Terms of Use
+ </a>
+ <a href="https://www.eclipse.org/legal/copyright.php" target="_blank">
+ > Copyright Agent
+ </a>
+ <a href="https://www.eclipse.org/legal" target="_blank">
+ > Legal
+ </a>
+ <a href="https://www.eclipse.org/legal/epl-2.0/" target="_blank">
+ > License
+ </a>
+ <a href="https://eclipse.org/security" target="_blank">
+ > Report a Vulnerability
+ </a>
+ </div>
+ </div>
+ </div>
+</footer>
+
+
+ </div>
+ <!-- /.row -->
+</div>
+<!-- /.container -->
+</div>
+<!-- /#main -->
+ </div>
+
+</body>
+</html>
diff --git a/1.0/protocol-examples-policies-modifypolicyentries.html b/1.0/protocol-examples-policies-modifypolicyentries.html
new file mode 100644
index 0000000..0cb01de
--- /dev/null
+++ b/1.0/protocol-examples-policies-modifypolicyentries.html
@@ -0,0 +1,1590 @@
+<!DOCTYPE html>
+<html>
+<head>
+ <meta charset="utf-8">
+<meta http-equiv="X-UA-Compatible" content="IE=edge">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="description" content="">
+<meta name="keywords" content=" examples, modify policy entries">
+<title> Modify Policy entries • Eclipse Ditto • a digital twin framework</title>
+
+<link rel="stylesheet" href="css/syntax.css">
+<link rel="stylesheet" type="text/css" href="//cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/modern-business.css">
+<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/customstyles.css">
+<link rel="stylesheet" href="css/boxshadowproperties.css">
+<link rel="stylesheet" href="css/theme-ditto.css">
+<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:400,700|Source+Code+Pro:300,600|Titillium+Web:400,600,700">
+
+<script src="//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.4/jquery.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/js/bootstrap.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/anchor-js/2.0.0/anchor.min.js" crossorigin="anonymous"></script>
+<script src="js/toc.js"></script>
+<script src="js/customscripts.js"></script>
+
+<script type="application/ld+json">
+{
+ "@context": "http://schema.org",
+ "@type": "Organization",
+ "url": "https://eclipse.org/ditto/",
+ "logo": "https://eclipse.org/ditto/images/ditto.svg"
+}
+</script>
+
+<link rel="icon" type="image/png" href="images/favicon-16x16.png" sizes="16x16">
+<link rel="icon" type="image/png" href="images/favicon-32x32.png" sizes="32x32">
+<link rel="icon" type="image/png" href="images/favicon-96x96.png" sizes="96x96">
+
+<link rel="alternate" type="application/rss+xml" title="Eclipse Ditto Blog" href="https://www.eclipse.org/ditto/feed.xml">
+
+<!-- Eclipse Foundation cookie consent: -->
+<link rel="stylesheet" type="text/css" href="//www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css" />
+<script src="//www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+ <script>
+ $(document).ready(function() {
+ $("#tg-sb-link").click(function() {
+ $("#tg-sb-sidebar").toggle();
+ $("#tg-sb-content").toggleClass('col-md-9');
+ $("#tg-sb-content").toggleClass('col-md-12');
+ $("#tg-sb-icon").toggleClass('fa-toggle-on');
+ $("#tg-sb-icon").toggleClass('fa-toggle-off');
+ });
+ });
+ </script>
+</head>
+
+
+<script>
+ (function(w,d,s,l,i){
+ w[l]=w[l]||[];
+ w[l].push({'gtm.start':
+ new Date().getTime(),event:'gtm.js'});
+ var f=d.getElementsByTagName(s)[0],
+ j=d.createElement(s),
+ dl=l!='dataLayer'?'&l='+l:'';
+ j.async=true;
+ j.src='https://www.googletagmanager.com/gtm.js?id='+i+dl;
+ f.parentNode.insertBefore(j,f);
+ })(window,document,'script','dataLayer','GTM-5WLCZXC');
+</script>
+
+
+
+<body>
+<!-- Navigation -->
+<nav class="navbar navbar-inverse navbar-fixed-top">
+ <div class="container topnavlinks">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-ditto-home" href="index.html"> <img src="images/ditto_allwhite_symbolonly.svg" class="ditto-navbar-symbol" alt="Home"> <img src="images/ditto_allwhite_textonly.svg" class="ditto-navbar-symbol-text" alt="Ditto"></a>
+ </div>
+ <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
+ <ul class="nav navbar-nav navbar-right">
+ <!-- toggle sidebar button -->
+ <!--<li><a id="tg-sb-link" href="#"><i id="tg-sb-icon" class="fa fa-toggle-on"></i> Nav</a></li>-->
+ <!-- entries without drop-downs appear here -->
+
+
+
+
+
+
+
+ <li><a href="blog.html">Blog</a></li>
+
+
+
+ <li><a href="intro-overview.html">Documentation</a></li>
+
+
+
+ <li><a href="http-api-doc.html">HTTP API</a></li>
+
+
+
+ <li><a href="https://ditto.eclipse.org" target="_blank">Sandbox</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">GitHub</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">GitHub examples</a></li>
+
+
+
+ <!-- entries with drop-downs appear here -->
+ <!-- conditional logic to control which topnav appears for the audience defined in the configuration file.-->
+
+
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Links<b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+
+ <li><a href="https://projects.eclipse.org/projects/iot.ditto" target="_blank">Eclipse Ditto Project</a></li>
+
+
+
+ <li><a href="https://www.eclipse.org/forums/index.php/f/364/" target="_blank">Forum</a></li>
+
+
+
+ <li><a href="https://ci.eclipse.org/ditto/" target="_blank">Jenkins</a></li>
+
+
+
+ <li><a href="https://dev.eclipse.org/mhonarc/lists/ditto-dev/" target="_blank">Mailing list archives</a></li>
+
+
+
+ <li><a href="https://gitter.im/eclipse/ditto" target="_blank">Gitter.im chat</a></li>
+
+
+ </ul>
+ </li>
+
+
+
+ <!--comment out this block if you want to hide search-->
+ <li>
+ <!--start search-->
+ <div id="search-demo-container">
+ <input type="text" id="search-input" placeholder="search...">
+ <ul id="results-container"></ul>
+ </div>
+ <script src="//cdnjs.cloudflare.com/ajax/libs/simple-jekyll-search/0.0.9/jekyll-search.js" type="text/javascript"></script>
+ <script type="text/javascript">
+ SimpleJekyllSearch.init({
+ searchInput: document.getElementById('search-input'),
+ resultsContainer: document.getElementById('results-container'),
+ dataSource: 'search.json',
+ searchResultTemplate: '<li><a href="{url}" title="Modify Policy entries">{title}</a></li>',
+ noResultsText: 'No results found.',
+ limit: 10,
+ fuzzy: true,
+ })
+ </script>
+ <!--end search-->
+ </li>
+ </ul>
+ </div>
+ </div>
+ <!-- /.container -->
+</nav>
+
+<!-- Page Content -->
+<div class="container">
+ <div id="main">
+ <!-- Content Row -->
+ <div class="row">
+
+
+ <!-- Sidebar Column -->
+ <div class="col-md-3" id="tg-sb-sidebar">
+
+
+<ul id="mysidebar" class="nav">
+ <li class="sidebarTitle">
+ <label for="docVersion">Eclipse Ditto version:</label>
+ <div class="select-wrapper">
+ <select id="docVersion" name="docVersion">
+
+ <option value="">development</option>
+
+ <option value="1.0">1.0</option>
+
+ <option value="1.1">1.1</option>
+
+ </select>
+ </div>
+ <div id="dev-warning">
+ <div markdown="span" class="alert alert-warning" role="alert" style="font-size:0.6em"><i class="fa fa-warning"></i> <b>Important:</b> This documentation reflects the latest 'development'. You might want to choose a released version.</div>
+ </div>
+ </li>
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Introduction</a>
+ <ul>
+
+
+
+ <li><a href="intro-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="intro-digitaltwins.html">Digital twins</a></li>
+
+
+
+
+
+
+ <li><a href="intro-hello-world.html">Hello world</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Release Notes</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_100.html">1.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_090.html">0.9.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_080.html">0.8.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Milestone releases</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_100-M2.html">1.0.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_100-M1a.html">1.0.0-M1a</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M2.html">0.9.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M1.html">0.9.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M3.html">0.8.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M2.html">0.8.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M1.html">0.8.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M2.html">0.3.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M1.html">0.3.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_020-M1.html">0.2.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M3.html">0.1.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M1.html">0.1.0-M1</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Installation</a>
+ <ul>
+
+
+
+ <li><a href="installation-building.html">Building Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-running.html">Running Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-operating.html">Operating Ditto</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Basic concepts</a>
+ <ul>
+
+
+
+ <li><a href="basic-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Model entities</a>
+ <ul>
+
+
+
+ <li><a href="basic-thing.html">Thing</a></li>
+
+
+
+
+
+ <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
+
+
+
+
+
+ <li><a href="basic-feature.html">Feature</a></li>
+
+
+
+
+
+ <li><a href="basic-policy.html">Policy</a></li>
+
+
+
+
+
+ <li><a href="basic-namespaces-and-names.html">Namespaces and Names</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-auth.html">Authentication and Authorization</a></li>
+
+
+
+
+
+
+ <li><a href="basic-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="basic-signals.html">Signals</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Signal types</a>
+ <ul>
+
+
+
+ <li><a href="basic-signals-command.html">Command</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-commandresponse.html">Command response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-errorresponse.html">Error response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-event.html">Event</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-apis.html">APIs</a></li>
+
+
+
+
+
+
+ <li><a href="basic-connections.html">Connections</a></li>
+
+
+
+
+
+
+ <li><a href="basic-placeholders.html">Placeholders</a></li>
+
+
+
+
+
+
+ <li><a href="basic-changenotifications.html">Change notifications</a></li>
+
+
+
+
+
+
+ <li><a href="basic-rql.html">RQL expressions</a></li>
+
+
+
+
+
+
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
+ <li><a href="basic-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Architecture</a>
+ <ul>
+
+
+
+ <li><a href="architecture-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Services</a>
+ <ul>
+
+
+
+ <li><a href="architecture-services-policies.html">Policies</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things.html">Things</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things-search.html">Things-Search</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-connectivity.html">Connectivity</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-concierge.html">Concierge</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-gateway.html">Gateway</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>HTTP API</a>
+ <ul>
+
+
+
+ <li><a href="httpapi-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-concepts.html">Concepts</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-protocol-bindings-websocket.html">WebSocket protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-sse.html">Server sent events</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Connectivity API</a>
+ <ul>
+
+
+
+ <li><a href="connectivity-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-manage-connections.html">Manage connections</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp091.html">AMQP 0.9.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp10.html">AMQP 1.0 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-kafka2.html">Kafka 2.x protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-mapping.html">Payload mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-header-mapping.html">Header mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-tls-certificates.html">TLS certificates</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Client SDK</a>
+ <ul>
+
+
+
+ <li><a href="client-sdk-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-java.html">Java</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-javascript.html">JavaScript</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Ditto Protocol</a>
+ <ul>
+
+
+
+ <li><a href="protocol-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-twinlive.html">Twin/live channel</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification.html">Specification</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-topic.html">Protocol topic</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-things.html">Things group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-delete.html">Delete</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ search/messages</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-search.html">Search</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-messages.html">Messages</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-bindings.html">Bindings</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-examples.html">Examples</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-creatething.html">Create a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletething.html">Delete a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifything.html">Modify a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievething.html">Retrieve a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethings.html">Retrieve multiple Things</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattributes.html">Delete Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattributes.html">Modify Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattributes.html">Retrieve Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattribute.html">Create a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattribute.html">Delete a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattribute.html">Modify a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattribute.html">Retrieve a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createthingdefinition.html">Create a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletethingdefinition.html">Delete a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifythingdefinition.html">Modify a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethingdefinition.html">Retrieve a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeatures.html">Create Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeatures.html">Delete Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeatures.html">Modify Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeatures.html">Retrieve Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeature.html">Create a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeature.html">Delete a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeature.html">Modify a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeature.html">Retrieve a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdefinition.html">Create Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedefinition.html">Delete Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydefinition.html">Modify Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedefinition.html">Retrieve Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperties.html">Create Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperties.html">Delete Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperties.html">Modify Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperties.html">Retrieve Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperty.html">Create a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperty.html">Delete a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperty.html">Modify a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperty.html">Retrieve a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li class="active"><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li><a href="sandbox.html">Sandbox</a></li>
+
+
+
+
+
+ <li><a href="presentations.html">Presentations</a></li>
+
+
+
+
+
+ <li><a href="glossary.html">Glossary</a></li>
+
+
+
+
+
+ <li><a href="feedback.html">Feedback</a></li>
+
+
+
+
+
+ <p class="external">
+ <a href="#" id="collapseAll">Collapse All</a> | <a href="#" id="expandAll">Expand All</a>
+ </p>
+
+</ul>
+
+<!-- this highlights the active parent class in the sidebar. this is critical so that the parent expands when you're viewing a page. This must appear below the sidebar code above. Otherwise, if placed inside customscripts.js, the script runs before the sidebar code runs and the class never gets inserted.-->
+<script>$("li.active").parents('li').toggleClass("active");
+
+$(function() {
+ $("#dev-warning").hide();
+ changeSelectedDocVersionDropdownSelection($("#docVersion")[0]);
+ $("#docVersion").change(changeSelectedDocVersion);
+});
+
+function changeSelectedDocVersionDropdownSelection(element) {
+ var pathName = window.location.pathname;
+
+ var versionOptions = element.options;
+ for (var i = 0; i < versionOptions.length; i++) {
+ var versionValue = versionOptions[i].value;
+ if ((versionValue !== "") && pathName.startsWith("/ditto/"+versionValue+"/")) {
+ $("#docVersion").val(versionValue).change();
+ return;
+ }
+ }
+ // fallback: dev with "empty" version value:
+ $("#docVersion").val("").change();
+ $("#dev-warning").show();
+}
+function changeSelectedDocVersion() {
+ var versionValue = $('#docVersion').val();
+ var remainingPath = window.location.pathname.replace("/ditto/", "");
+ var versionMatch = remainingPath.match("([0-9].[0.9])/(.*)");
+ if (versionValue === "" && !versionMatch) {
+ // do nothing, we're already on the correct "dev" version
+ } else if (versionMatch && (versionValue === versionMatch[1])) {
+ // do nothing, we're already on the correct version
+ } else {
+ if (versionValue === "" && versionMatch) {
+ window.location.pathname = "ditto/" + versionMatch[2];
+ } else if (versionValue === "") {
+ window.location.pathname = "ditto/" + remainingPath;
+ } else if (versionMatch) {
+ window.location.pathname = "ditto/" + versionValue + "/" + versionMatch[2];
+ } else {
+ window.location.pathname = "ditto/" + versionValue + "/" + remainingPath;
+ }
+ }
+}
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Modify Policy entries</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+
+
+
+<!-- this handles the automatic toc. use ## for subheads to auto-generate the on-page minitoc. if you use html tags, you must supply an ID for the heading element in order for it to appear in the minitoc. -->
+<script>
+$( document ).ready(function() {
+ // Handler for .ready() called.
+
+$('#toc').toc({ minimumHeaders: 0, listType: 'ul', showSpeed: 0, headers: 'h2,h3,h4' });
+
+/* this offset helps account for the space taken up by the floating toolbar. */
+$('#toc').on('click', 'a', function() {
+ var target = $(this.getAttribute('href'))
+ , scroll_target = target.offset().top
+
+ $(window).scrollTop(scroll_target - 10);
+ return false
+})
+
+});
+</script>
+
+<div id="toc"></div>
+
+
+
+
+
+
+
+
+
+
+<h2 id="modifypolicyentries">ModifyPolicyEntries</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/the_policy_id/policies/commands/modify"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/entries"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"another_label"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"__schemaVersion"</span><span class="p">:</span><span class="w"> </span><span class="mi">2</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"subjects"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"google:the_subjectid"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"__schemaVersion"</span><span class="p">:</span><span class="w"> </span><span class="mi">2</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"yourSubjectTypeDescription"</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"resources"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"thing:/the_resource_path"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"__schemaVersion"</span><span class="p">:</span><span class="w"> </span><span class="mi">2</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"grant"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
+ </span><span class="s2">"READ"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"WRITE"</span><span class="w">
+ </span><span class="p">],</span><span class="w">
+ </span><span class="s2">"revoke"</span><span class="p">:</span><span class="w"> </span><span class="p">[]</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"the_label"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"__schemaVersion"</span><span class="p">:</span><span class="w"> </span><span class="mi">2</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"subjects"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"google:the_subjectid"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"__schemaVersion"</span><span class="p">:</span><span class="w"> </span><span class="mi">2</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"yourSubjectTypeDescription"</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"resources"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"thing:/the_resource_path"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"__schemaVersion"</span><span class="p">:</span><span class="w"> </span><span class="mi">2</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"grant"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
+ </span><span class="s2">"READ"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"WRITE"</span><span class="w">
+ </span><span class="p">],</span><span class="w">
+ </span><span class="s2">"revoke"</span><span class="p">:</span><span class="w"> </span><span class="p">[]</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="modifypolicyentriesresponse">ModifyPolicyEntriesResponse</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/the_policy_id/policies/commands/modify"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/entries"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">204</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+
+
+ <div class="tags">
+
+ </div>
+
+</div>
+
+<hr class="shaded"/>
+
+<footer>
+ <div class="row">
+ <div class="col-lg-12 footer">
+ <div class="logo">
+ <a href="https://eclipse.org"><img src="images/eclipse_foundation_logo.svg" alt="Eclipse logo"/></a>
+ </div>
+ <p class="notice">
+ ©2020 Eclipse Ditto.
+ Site last generated: Jul 1, 2020 <br />
+ </p>
+ <div class="quickLinks">
+ <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
+ > Privacy Policy
+ </a>
+ <a href="https://www.eclipse.org/legal/termsofuse.php" target="_blank">
+ > Terms of Use
+ </a>
+ <a href="https://www.eclipse.org/legal/copyright.php" target="_blank">
+ > Copyright Agent
+ </a>
+ <a href="https://www.eclipse.org/legal" target="_blank">
+ > Legal
+ </a>
+ <a href="https://www.eclipse.org/legal/epl-2.0/" target="_blank">
+ > License
+ </a>
+ <a href="https://eclipse.org/security" target="_blank">
+ > Report a Vulnerability
+ </a>
+ </div>
+ </div>
+ </div>
+</footer>
+
+
+ </div>
+ <!-- /.row -->
+</div>
+<!-- /.container -->
+</div>
+<!-- /#main -->
+ </div>
+
+</body>
+</html>
diff --git a/1.0/protocol-examples-policies-modifypolicyentry.html b/1.0/protocol-examples-policies-modifypolicyentry.html
new file mode 100644
index 0000000..0587768
--- /dev/null
+++ b/1.0/protocol-examples-policies-modifypolicyentry.html
@@ -0,0 +1,1568 @@
+<!DOCTYPE html>
+<html>
+<head>
+ <meta charset="utf-8">
+<meta http-equiv="X-UA-Compatible" content="IE=edge">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="description" content="">
+<meta name="keywords" content=" examples, modify policy entry">
+<title> Modify a Policy entry • Eclipse Ditto • a digital twin framework</title>
+
+<link rel="stylesheet" href="css/syntax.css">
+<link rel="stylesheet" type="text/css" href="//cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/modern-business.css">
+<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/customstyles.css">
+<link rel="stylesheet" href="css/boxshadowproperties.css">
+<link rel="stylesheet" href="css/theme-ditto.css">
+<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:400,700|Source+Code+Pro:300,600|Titillium+Web:400,600,700">
+
+<script src="//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.4/jquery.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/js/bootstrap.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/anchor-js/2.0.0/anchor.min.js" crossorigin="anonymous"></script>
+<script src="js/toc.js"></script>
+<script src="js/customscripts.js"></script>
+
+<script type="application/ld+json">
+{
+ "@context": "http://schema.org",
+ "@type": "Organization",
+ "url": "https://eclipse.org/ditto/",
+ "logo": "https://eclipse.org/ditto/images/ditto.svg"
+}
+</script>
+
+<link rel="icon" type="image/png" href="images/favicon-16x16.png" sizes="16x16">
+<link rel="icon" type="image/png" href="images/favicon-32x32.png" sizes="32x32">
+<link rel="icon" type="image/png" href="images/favicon-96x96.png" sizes="96x96">
+
+<link rel="alternate" type="application/rss+xml" title="Eclipse Ditto Blog" href="https://www.eclipse.org/ditto/feed.xml">
+
+<!-- Eclipse Foundation cookie consent: -->
+<link rel="stylesheet" type="text/css" href="//www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css" />
+<script src="//www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+ <script>
+ $(document).ready(function() {
+ $("#tg-sb-link").click(function() {
+ $("#tg-sb-sidebar").toggle();
+ $("#tg-sb-content").toggleClass('col-md-9');
+ $("#tg-sb-content").toggleClass('col-md-12');
+ $("#tg-sb-icon").toggleClass('fa-toggle-on');
+ $("#tg-sb-icon").toggleClass('fa-toggle-off');
+ });
+ });
+ </script>
+</head>
+
+
+<script>
+ (function(w,d,s,l,i){
+ w[l]=w[l]||[];
+ w[l].push({'gtm.start':
+ new Date().getTime(),event:'gtm.js'});
+ var f=d.getElementsByTagName(s)[0],
+ j=d.createElement(s),
+ dl=l!='dataLayer'?'&l='+l:'';
+ j.async=true;
+ j.src='https://www.googletagmanager.com/gtm.js?id='+i+dl;
+ f.parentNode.insertBefore(j,f);
+ })(window,document,'script','dataLayer','GTM-5WLCZXC');
+</script>
+
+
+
+<body>
+<!-- Navigation -->
+<nav class="navbar navbar-inverse navbar-fixed-top">
+ <div class="container topnavlinks">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-ditto-home" href="index.html"> <img src="images/ditto_allwhite_symbolonly.svg" class="ditto-navbar-symbol" alt="Home"> <img src="images/ditto_allwhite_textonly.svg" class="ditto-navbar-symbol-text" alt="Ditto"></a>
+ </div>
+ <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
+ <ul class="nav navbar-nav navbar-right">
+ <!-- toggle sidebar button -->
+ <!--<li><a id="tg-sb-link" href="#"><i id="tg-sb-icon" class="fa fa-toggle-on"></i> Nav</a></li>-->
+ <!-- entries without drop-downs appear here -->
+
+
+
+
+
+
+
+ <li><a href="blog.html">Blog</a></li>
+
+
+
+ <li><a href="intro-overview.html">Documentation</a></li>
+
+
+
+ <li><a href="http-api-doc.html">HTTP API</a></li>
+
+
+
+ <li><a href="https://ditto.eclipse.org" target="_blank">Sandbox</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">GitHub</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">GitHub examples</a></li>
+
+
+
+ <!-- entries with drop-downs appear here -->
+ <!-- conditional logic to control which topnav appears for the audience defined in the configuration file.-->
+
+
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Links<b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+
+ <li><a href="https://projects.eclipse.org/projects/iot.ditto" target="_blank">Eclipse Ditto Project</a></li>
+
+
+
+ <li><a href="https://www.eclipse.org/forums/index.php/f/364/" target="_blank">Forum</a></li>
+
+
+
+ <li><a href="https://ci.eclipse.org/ditto/" target="_blank">Jenkins</a></li>
+
+
+
+ <li><a href="https://dev.eclipse.org/mhonarc/lists/ditto-dev/" target="_blank">Mailing list archives</a></li>
+
+
+
+ <li><a href="https://gitter.im/eclipse/ditto" target="_blank">Gitter.im chat</a></li>
+
+
+ </ul>
+ </li>
+
+
+
+ <!--comment out this block if you want to hide search-->
+ <li>
+ <!--start search-->
+ <div id="search-demo-container">
+ <input type="text" id="search-input" placeholder="search...">
+ <ul id="results-container"></ul>
+ </div>
+ <script src="//cdnjs.cloudflare.com/ajax/libs/simple-jekyll-search/0.0.9/jekyll-search.js" type="text/javascript"></script>
+ <script type="text/javascript">
+ SimpleJekyllSearch.init({
+ searchInput: document.getElementById('search-input'),
+ resultsContainer: document.getElementById('results-container'),
+ dataSource: 'search.json',
+ searchResultTemplate: '<li><a href="{url}" title="Modify a Policy entry">{title}</a></li>',
+ noResultsText: 'No results found.',
+ limit: 10,
+ fuzzy: true,
+ })
+ </script>
+ <!--end search-->
+ </li>
+ </ul>
+ </div>
+ </div>
+ <!-- /.container -->
+</nav>
+
+<!-- Page Content -->
+<div class="container">
+ <div id="main">
+ <!-- Content Row -->
+ <div class="row">
+
+
+ <!-- Sidebar Column -->
+ <div class="col-md-3" id="tg-sb-sidebar">
+
+
+<ul id="mysidebar" class="nav">
+ <li class="sidebarTitle">
+ <label for="docVersion">Eclipse Ditto version:</label>
+ <div class="select-wrapper">
+ <select id="docVersion" name="docVersion">
+
+ <option value="">development</option>
+
+ <option value="1.0">1.0</option>
+
+ <option value="1.1">1.1</option>
+
+ </select>
+ </div>
+ <div id="dev-warning">
+ <div markdown="span" class="alert alert-warning" role="alert" style="font-size:0.6em"><i class="fa fa-warning"></i> <b>Important:</b> This documentation reflects the latest 'development'. You might want to choose a released version.</div>
+ </div>
+ </li>
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Introduction</a>
+ <ul>
+
+
+
+ <li><a href="intro-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="intro-digitaltwins.html">Digital twins</a></li>
+
+
+
+
+
+
+ <li><a href="intro-hello-world.html">Hello world</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Release Notes</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_100.html">1.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_090.html">0.9.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_080.html">0.8.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Milestone releases</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_100-M2.html">1.0.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_100-M1a.html">1.0.0-M1a</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M2.html">0.9.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M1.html">0.9.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M3.html">0.8.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M2.html">0.8.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M1.html">0.8.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M2.html">0.3.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M1.html">0.3.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_020-M1.html">0.2.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M3.html">0.1.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M1.html">0.1.0-M1</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Installation</a>
+ <ul>
+
+
+
+ <li><a href="installation-building.html">Building Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-running.html">Running Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-operating.html">Operating Ditto</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Basic concepts</a>
+ <ul>
+
+
+
+ <li><a href="basic-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Model entities</a>
+ <ul>
+
+
+
+ <li><a href="basic-thing.html">Thing</a></li>
+
+
+
+
+
+ <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
+
+
+
+
+
+ <li><a href="basic-feature.html">Feature</a></li>
+
+
+
+
+
+ <li><a href="basic-policy.html">Policy</a></li>
+
+
+
+
+
+ <li><a href="basic-namespaces-and-names.html">Namespaces and Names</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-auth.html">Authentication and Authorization</a></li>
+
+
+
+
+
+
+ <li><a href="basic-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="basic-signals.html">Signals</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Signal types</a>
+ <ul>
+
+
+
+ <li><a href="basic-signals-command.html">Command</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-commandresponse.html">Command response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-errorresponse.html">Error response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-event.html">Event</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-apis.html">APIs</a></li>
+
+
+
+
+
+
+ <li><a href="basic-connections.html">Connections</a></li>
+
+
+
+
+
+
+ <li><a href="basic-placeholders.html">Placeholders</a></li>
+
+
+
+
+
+
+ <li><a href="basic-changenotifications.html">Change notifications</a></li>
+
+
+
+
+
+
+ <li><a href="basic-rql.html">RQL expressions</a></li>
+
+
+
+
+
+
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
+ <li><a href="basic-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Architecture</a>
+ <ul>
+
+
+
+ <li><a href="architecture-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Services</a>
+ <ul>
+
+
+
+ <li><a href="architecture-services-policies.html">Policies</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things.html">Things</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things-search.html">Things-Search</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-connectivity.html">Connectivity</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-concierge.html">Concierge</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-gateway.html">Gateway</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>HTTP API</a>
+ <ul>
+
+
+
+ <li><a href="httpapi-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-concepts.html">Concepts</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-protocol-bindings-websocket.html">WebSocket protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-sse.html">Server sent events</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Connectivity API</a>
+ <ul>
+
+
+
+ <li><a href="connectivity-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-manage-connections.html">Manage connections</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp091.html">AMQP 0.9.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp10.html">AMQP 1.0 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-kafka2.html">Kafka 2.x protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-mapping.html">Payload mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-header-mapping.html">Header mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-tls-certificates.html">TLS certificates</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Client SDK</a>
+ <ul>
+
+
+
+ <li><a href="client-sdk-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-java.html">Java</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-javascript.html">JavaScript</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Ditto Protocol</a>
+ <ul>
+
+
+
+ <li><a href="protocol-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-twinlive.html">Twin/live channel</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification.html">Specification</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-topic.html">Protocol topic</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-things.html">Things group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-delete.html">Delete</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ search/messages</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-search.html">Search</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-messages.html">Messages</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-bindings.html">Bindings</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-examples.html">Examples</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-creatething.html">Create a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletething.html">Delete a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifything.html">Modify a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievething.html">Retrieve a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethings.html">Retrieve multiple Things</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattributes.html">Delete Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattributes.html">Modify Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattributes.html">Retrieve Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattribute.html">Create a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattribute.html">Delete a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattribute.html">Modify a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattribute.html">Retrieve a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createthingdefinition.html">Create a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletethingdefinition.html">Delete a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifythingdefinition.html">Modify a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethingdefinition.html">Retrieve a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeatures.html">Create Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeatures.html">Delete Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeatures.html">Modify Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeatures.html">Retrieve Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeature.html">Create a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeature.html">Delete a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeature.html">Modify a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeature.html">Retrieve a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdefinition.html">Create Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedefinition.html">Delete Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydefinition.html">Modify Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedefinition.html">Retrieve Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperties.html">Create Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperties.html">Delete Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperties.html">Modify Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperties.html">Retrieve Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperty.html">Create a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperty.html">Delete a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperty.html">Modify a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperty.html">Retrieve a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li class="active"><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li><a href="sandbox.html">Sandbox</a></li>
+
+
+
+
+
+ <li><a href="presentations.html">Presentations</a></li>
+
+
+
+
+
+ <li><a href="glossary.html">Glossary</a></li>
+
+
+
+
+
+ <li><a href="feedback.html">Feedback</a></li>
+
+
+
+
+
+ <p class="external">
+ <a href="#" id="collapseAll">Collapse All</a> | <a href="#" id="expandAll">Expand All</a>
+ </p>
+
+</ul>
+
+<!-- this highlights the active parent class in the sidebar. this is critical so that the parent expands when you're viewing a page. This must appear below the sidebar code above. Otherwise, if placed inside customscripts.js, the script runs before the sidebar code runs and the class never gets inserted.-->
+<script>$("li.active").parents('li').toggleClass("active");
+
+$(function() {
+ $("#dev-warning").hide();
+ changeSelectedDocVersionDropdownSelection($("#docVersion")[0]);
+ $("#docVersion").change(changeSelectedDocVersion);
+});
+
+function changeSelectedDocVersionDropdownSelection(element) {
+ var pathName = window.location.pathname;
+
+ var versionOptions = element.options;
+ for (var i = 0; i < versionOptions.length; i++) {
+ var versionValue = versionOptions[i].value;
+ if ((versionValue !== "") && pathName.startsWith("/ditto/"+versionValue+"/")) {
+ $("#docVersion").val(versionValue).change();
+ return;
+ }
+ }
+ // fallback: dev with "empty" version value:
+ $("#docVersion").val("").change();
+ $("#dev-warning").show();
+}
+function changeSelectedDocVersion() {
+ var versionValue = $('#docVersion').val();
+ var remainingPath = window.location.pathname.replace("/ditto/", "");
+ var versionMatch = remainingPath.match("([0-9].[0.9])/(.*)");
+ if (versionValue === "" && !versionMatch) {
+ // do nothing, we're already on the correct "dev" version
+ } else if (versionMatch && (versionValue === versionMatch[1])) {
+ // do nothing, we're already on the correct version
+ } else {
+ if (versionValue === "" && versionMatch) {
+ window.location.pathname = "ditto/" + versionMatch[2];
+ } else if (versionValue === "") {
+ window.location.pathname = "ditto/" + remainingPath;
+ } else if (versionMatch) {
+ window.location.pathname = "ditto/" + versionValue + "/" + versionMatch[2];
+ } else {
+ window.location.pathname = "ditto/" + versionValue + "/" + remainingPath;
+ }
+ }
+}
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Modify a Policy entry</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+
+
+
+<!-- this handles the automatic toc. use ## for subheads to auto-generate the on-page minitoc. if you use html tags, you must supply an ID for the heading element in order for it to appear in the minitoc. -->
+<script>
+$( document ).ready(function() {
+ // Handler for .ready() called.
+
+$('#toc').toc({ minimumHeaders: 0, listType: 'ul', showSpeed: 0, headers: 'h2,h3,h4' });
+
+/* this offset helps account for the space taken up by the floating toolbar. */
+$('#toc').on('click', 'a', function() {
+ var target = $(this.getAttribute('href'))
+ , scroll_target = target.offset().top
+
+ $(window).scrollTop(scroll_target - 10);
+ return false
+})
+
+});
+</script>
+
+<div id="toc"></div>
+
+
+
+
+
+
+
+
+
+
+<h2 id="modifypolicyentry">ModifyPolicyEntry</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/the_policy_id/policies/commands/modify"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/entries/the_label"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"subjects"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"google:the_subjectid"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"__schemaVersion"</span><span class="p">:</span><span class="w"> </span><span class="mi">2</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"yourSubjectTypeDescription"</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"resources"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"thing:/the_resource_path"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"__schemaVersion"</span><span class="p">:</span><span class="w"> </span><span class="mi">2</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"grant"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
+ </span><span class="s2">"READ"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"WRITE"</span><span class="w">
+ </span><span class="p">],</span><span class="w">
+ </span><span class="s2">"revoke"</span><span class="p">:</span><span class="w"> </span><span class="p">[]</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="modifypolicyentryresponse">ModifyPolicyEntryResponse</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/the_policy_id/policies/commands/modify"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/entries/the_label"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">204</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+
+
+ <div class="tags">
+
+ </div>
+
+</div>
+
+<hr class="shaded"/>
+
+<footer>
+ <div class="row">
+ <div class="col-lg-12 footer">
+ <div class="logo">
+ <a href="https://eclipse.org"><img src="images/eclipse_foundation_logo.svg" alt="Eclipse logo"/></a>
+ </div>
+ <p class="notice">
+ ©2020 Eclipse Ditto.
+ Site last generated: Jul 1, 2020 <br />
+ </p>
+ <div class="quickLinks">
+ <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
+ > Privacy Policy
+ </a>
+ <a href="https://www.eclipse.org/legal/termsofuse.php" target="_blank">
+ > Terms of Use
+ </a>
+ <a href="https://www.eclipse.org/legal/copyright.php" target="_blank">
+ > Copyright Agent
+ </a>
+ <a href="https://www.eclipse.org/legal" target="_blank">
+ > Legal
+ </a>
+ <a href="https://www.eclipse.org/legal/epl-2.0/" target="_blank">
+ > License
+ </a>
+ <a href="https://eclipse.org/security" target="_blank">
+ > Report a Vulnerability
+ </a>
+ </div>
+ </div>
+ </div>
+</footer>
+
+
+ </div>
+ <!-- /.row -->
+</div>
+<!-- /.container -->
+</div>
+<!-- /#main -->
+ </div>
+
+</body>
+</html>
diff --git a/1.0/protocol-examples-policies-modifyresource.html b/1.0/protocol-examples-policies-modifyresource.html
new file mode 100644
index 0000000..5c788a5
--- /dev/null
+++ b/1.0/protocol-examples-policies-modifyresource.html
@@ -0,0 +1,1557 @@
+<!DOCTYPE html>
+<html>
+<head>
+ <meta charset="utf-8">
+<meta http-equiv="X-UA-Compatible" content="IE=edge">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="description" content="">
+<meta name="keywords" content=" examples, modify resource">
+<title> Modify a resource • Eclipse Ditto • a digital twin framework</title>
+
+<link rel="stylesheet" href="css/syntax.css">
+<link rel="stylesheet" type="text/css" href="//cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/modern-business.css">
+<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/customstyles.css">
+<link rel="stylesheet" href="css/boxshadowproperties.css">
+<link rel="stylesheet" href="css/theme-ditto.css">
+<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:400,700|Source+Code+Pro:300,600|Titillium+Web:400,600,700">
+
+<script src="//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.4/jquery.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/js/bootstrap.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/anchor-js/2.0.0/anchor.min.js" crossorigin="anonymous"></script>
+<script src="js/toc.js"></script>
+<script src="js/customscripts.js"></script>
+
+<script type="application/ld+json">
+{
+ "@context": "http://schema.org",
+ "@type": "Organization",
+ "url": "https://eclipse.org/ditto/",
+ "logo": "https://eclipse.org/ditto/images/ditto.svg"
+}
+</script>
+
+<link rel="icon" type="image/png" href="images/favicon-16x16.png" sizes="16x16">
+<link rel="icon" type="image/png" href="images/favicon-32x32.png" sizes="32x32">
+<link rel="icon" type="image/png" href="images/favicon-96x96.png" sizes="96x96">
+
+<link rel="alternate" type="application/rss+xml" title="Eclipse Ditto Blog" href="https://www.eclipse.org/ditto/feed.xml">
+
+<!-- Eclipse Foundation cookie consent: -->
+<link rel="stylesheet" type="text/css" href="//www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css" />
+<script src="//www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+ <script>
+ $(document).ready(function() {
+ $("#tg-sb-link").click(function() {
+ $("#tg-sb-sidebar").toggle();
+ $("#tg-sb-content").toggleClass('col-md-9');
+ $("#tg-sb-content").toggleClass('col-md-12');
+ $("#tg-sb-icon").toggleClass('fa-toggle-on');
+ $("#tg-sb-icon").toggleClass('fa-toggle-off');
+ });
+ });
+ </script>
+</head>
+
+
+<script>
+ (function(w,d,s,l,i){
+ w[l]=w[l]||[];
+ w[l].push({'gtm.start':
+ new Date().getTime(),event:'gtm.js'});
+ var f=d.getElementsByTagName(s)[0],
+ j=d.createElement(s),
+ dl=l!='dataLayer'?'&l='+l:'';
+ j.async=true;
+ j.src='https://www.googletagmanager.com/gtm.js?id='+i+dl;
+ f.parentNode.insertBefore(j,f);
+ })(window,document,'script','dataLayer','GTM-5WLCZXC');
+</script>
+
+
+
+<body>
+<!-- Navigation -->
+<nav class="navbar navbar-inverse navbar-fixed-top">
+ <div class="container topnavlinks">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-ditto-home" href="index.html"> <img src="images/ditto_allwhite_symbolonly.svg" class="ditto-navbar-symbol" alt="Home"> <img src="images/ditto_allwhite_textonly.svg" class="ditto-navbar-symbol-text" alt="Ditto"></a>
+ </div>
+ <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
+ <ul class="nav navbar-nav navbar-right">
+ <!-- toggle sidebar button -->
+ <!--<li><a id="tg-sb-link" href="#"><i id="tg-sb-icon" class="fa fa-toggle-on"></i> Nav</a></li>-->
+ <!-- entries without drop-downs appear here -->
+
+
+
+
+
+
+
+ <li><a href="blog.html">Blog</a></li>
+
+
+
+ <li><a href="intro-overview.html">Documentation</a></li>
+
+
+
+ <li><a href="http-api-doc.html">HTTP API</a></li>
+
+
+
+ <li><a href="https://ditto.eclipse.org" target="_blank">Sandbox</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">GitHub</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">GitHub examples</a></li>
+
+
+
+ <!-- entries with drop-downs appear here -->
+ <!-- conditional logic to control which topnav appears for the audience defined in the configuration file.-->
+
+
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Links<b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+
+ <li><a href="https://projects.eclipse.org/projects/iot.ditto" target="_blank">Eclipse Ditto Project</a></li>
+
+
+
+ <li><a href="https://www.eclipse.org/forums/index.php/f/364/" target="_blank">Forum</a></li>
+
+
+
+ <li><a href="https://ci.eclipse.org/ditto/" target="_blank">Jenkins</a></li>
+
+
+
+ <li><a href="https://dev.eclipse.org/mhonarc/lists/ditto-dev/" target="_blank">Mailing list archives</a></li>
+
+
+
+ <li><a href="https://gitter.im/eclipse/ditto" target="_blank">Gitter.im chat</a></li>
+
+
+ </ul>
+ </li>
+
+
+
+ <!--comment out this block if you want to hide search-->
+ <li>
+ <!--start search-->
+ <div id="search-demo-container">
+ <input type="text" id="search-input" placeholder="search...">
+ <ul id="results-container"></ul>
+ </div>
+ <script src="//cdnjs.cloudflare.com/ajax/libs/simple-jekyll-search/0.0.9/jekyll-search.js" type="text/javascript"></script>
+ <script type="text/javascript">
+ SimpleJekyllSearch.init({
+ searchInput: document.getElementById('search-input'),
+ resultsContainer: document.getElementById('results-container'),
+ dataSource: 'search.json',
+ searchResultTemplate: '<li><a href="{url}" title="Modify a resource">{title}</a></li>',
+ noResultsText: 'No results found.',
+ limit: 10,
+ fuzzy: true,
+ })
+ </script>
+ <!--end search-->
+ </li>
+ </ul>
+ </div>
+ </div>
+ <!-- /.container -->
+</nav>
+
+<!-- Page Content -->
+<div class="container">
+ <div id="main">
+ <!-- Content Row -->
+ <div class="row">
+
+
+ <!-- Sidebar Column -->
+ <div class="col-md-3" id="tg-sb-sidebar">
+
+
+<ul id="mysidebar" class="nav">
+ <li class="sidebarTitle">
+ <label for="docVersion">Eclipse Ditto version:</label>
+ <div class="select-wrapper">
+ <select id="docVersion" name="docVersion">
+
+ <option value="">development</option>
+
+ <option value="1.0">1.0</option>
+
+ <option value="1.1">1.1</option>
+
+ </select>
+ </div>
+ <div id="dev-warning">
+ <div markdown="span" class="alert alert-warning" role="alert" style="font-size:0.6em"><i class="fa fa-warning"></i> <b>Important:</b> This documentation reflects the latest 'development'. You might want to choose a released version.</div>
+ </div>
+ </li>
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Introduction</a>
+ <ul>
+
+
+
+ <li><a href="intro-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="intro-digitaltwins.html">Digital twins</a></li>
+
+
+
+
+
+
+ <li><a href="intro-hello-world.html">Hello world</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Release Notes</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_100.html">1.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_090.html">0.9.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_080.html">0.8.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Milestone releases</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_100-M2.html">1.0.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_100-M1a.html">1.0.0-M1a</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M2.html">0.9.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M1.html">0.9.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M3.html">0.8.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M2.html">0.8.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M1.html">0.8.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M2.html">0.3.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M1.html">0.3.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_020-M1.html">0.2.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M3.html">0.1.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M1.html">0.1.0-M1</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Installation</a>
+ <ul>
+
+
+
+ <li><a href="installation-building.html">Building Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-running.html">Running Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-operating.html">Operating Ditto</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Basic concepts</a>
+ <ul>
+
+
+
+ <li><a href="basic-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Model entities</a>
+ <ul>
+
+
+
+ <li><a href="basic-thing.html">Thing</a></li>
+
+
+
+
+
+ <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
+
+
+
+
+
+ <li><a href="basic-feature.html">Feature</a></li>
+
+
+
+
+
+ <li><a href="basic-policy.html">Policy</a></li>
+
+
+
+
+
+ <li><a href="basic-namespaces-and-names.html">Namespaces and Names</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-auth.html">Authentication and Authorization</a></li>
+
+
+
+
+
+
+ <li><a href="basic-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="basic-signals.html">Signals</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Signal types</a>
+ <ul>
+
+
+
+ <li><a href="basic-signals-command.html">Command</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-commandresponse.html">Command response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-errorresponse.html">Error response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-event.html">Event</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-apis.html">APIs</a></li>
+
+
+
+
+
+
+ <li><a href="basic-connections.html">Connections</a></li>
+
+
+
+
+
+
+ <li><a href="basic-placeholders.html">Placeholders</a></li>
+
+
+
+
+
+
+ <li><a href="basic-changenotifications.html">Change notifications</a></li>
+
+
+
+
+
+
+ <li><a href="basic-rql.html">RQL expressions</a></li>
+
+
+
+
+
+
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
+ <li><a href="basic-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Architecture</a>
+ <ul>
+
+
+
+ <li><a href="architecture-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Services</a>
+ <ul>
+
+
+
+ <li><a href="architecture-services-policies.html">Policies</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things.html">Things</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things-search.html">Things-Search</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-connectivity.html">Connectivity</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-concierge.html">Concierge</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-gateway.html">Gateway</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>HTTP API</a>
+ <ul>
+
+
+
+ <li><a href="httpapi-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-concepts.html">Concepts</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-protocol-bindings-websocket.html">WebSocket protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-sse.html">Server sent events</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Connectivity API</a>
+ <ul>
+
+
+
+ <li><a href="connectivity-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-manage-connections.html">Manage connections</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp091.html">AMQP 0.9.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp10.html">AMQP 1.0 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-kafka2.html">Kafka 2.x protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-mapping.html">Payload mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-header-mapping.html">Header mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-tls-certificates.html">TLS certificates</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Client SDK</a>
+ <ul>
+
+
+
+ <li><a href="client-sdk-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-java.html">Java</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-javascript.html">JavaScript</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Ditto Protocol</a>
+ <ul>
+
+
+
+ <li><a href="protocol-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-twinlive.html">Twin/live channel</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification.html">Specification</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-topic.html">Protocol topic</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-things.html">Things group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-delete.html">Delete</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ search/messages</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-search.html">Search</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-messages.html">Messages</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-bindings.html">Bindings</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-examples.html">Examples</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-creatething.html">Create a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletething.html">Delete a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifything.html">Modify a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievething.html">Retrieve a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethings.html">Retrieve multiple Things</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattributes.html">Delete Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattributes.html">Modify Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattributes.html">Retrieve Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattribute.html">Create a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattribute.html">Delete a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattribute.html">Modify a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattribute.html">Retrieve a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createthingdefinition.html">Create a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletethingdefinition.html">Delete a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifythingdefinition.html">Modify a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethingdefinition.html">Retrieve a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeatures.html">Create Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeatures.html">Delete Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeatures.html">Modify Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeatures.html">Retrieve Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeature.html">Create a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeature.html">Delete a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeature.html">Modify a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeature.html">Retrieve a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdefinition.html">Create Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedefinition.html">Delete Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydefinition.html">Modify Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedefinition.html">Retrieve Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperties.html">Create Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperties.html">Delete Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperties.html">Modify Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperties.html">Retrieve Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperty.html">Create a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperty.html">Delete a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperty.html">Modify a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperty.html">Retrieve a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li class="active"><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li><a href="sandbox.html">Sandbox</a></li>
+
+
+
+
+
+ <li><a href="presentations.html">Presentations</a></li>
+
+
+
+
+
+ <li><a href="glossary.html">Glossary</a></li>
+
+
+
+
+
+ <li><a href="feedback.html">Feedback</a></li>
+
+
+
+
+
+ <p class="external">
+ <a href="#" id="collapseAll">Collapse All</a> | <a href="#" id="expandAll">Expand All</a>
+ </p>
+
+</ul>
+
+<!-- this highlights the active parent class in the sidebar. this is critical so that the parent expands when you're viewing a page. This must appear below the sidebar code above. Otherwise, if placed inside customscripts.js, the script runs before the sidebar code runs and the class never gets inserted.-->
+<script>$("li.active").parents('li').toggleClass("active");
+
+$(function() {
+ $("#dev-warning").hide();
+ changeSelectedDocVersionDropdownSelection($("#docVersion")[0]);
+ $("#docVersion").change(changeSelectedDocVersion);
+});
+
+function changeSelectedDocVersionDropdownSelection(element) {
+ var pathName = window.location.pathname;
+
+ var versionOptions = element.options;
+ for (var i = 0; i < versionOptions.length; i++) {
+ var versionValue = versionOptions[i].value;
+ if ((versionValue !== "") && pathName.startsWith("/ditto/"+versionValue+"/")) {
+ $("#docVersion").val(versionValue).change();
+ return;
+ }
+ }
+ // fallback: dev with "empty" version value:
+ $("#docVersion").val("").change();
+ $("#dev-warning").show();
+}
+function changeSelectedDocVersion() {
+ var versionValue = $('#docVersion').val();
+ var remainingPath = window.location.pathname.replace("/ditto/", "");
+ var versionMatch = remainingPath.match("([0-9].[0.9])/(.*)");
+ if (versionValue === "" && !versionMatch) {
+ // do nothing, we're already on the correct "dev" version
+ } else if (versionMatch && (versionValue === versionMatch[1])) {
+ // do nothing, we're already on the correct version
+ } else {
+ if (versionValue === "" && versionMatch) {
+ window.location.pathname = "ditto/" + versionMatch[2];
+ } else if (versionValue === "") {
+ window.location.pathname = "ditto/" + remainingPath;
+ } else if (versionMatch) {
+ window.location.pathname = "ditto/" + versionValue + "/" + versionMatch[2];
+ } else {
+ window.location.pathname = "ditto/" + versionValue + "/" + remainingPath;
+ }
+ }
+}
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Modify a resource</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+
+
+
+<!-- this handles the automatic toc. use ## for subheads to auto-generate the on-page minitoc. if you use html tags, you must supply an ID for the heading element in order for it to appear in the minitoc. -->
+<script>
+$( document ).ready(function() {
+ // Handler for .ready() called.
+
+$('#toc').toc({ minimumHeaders: 0, listType: 'ul', showSpeed: 0, headers: 'h2,h3,h4' });
+
+/* this offset helps account for the space taken up by the floating toolbar. */
+$('#toc').on('click', 'a', function() {
+ var target = $(this.getAttribute('href'))
+ , scroll_target = target.offset().top
+
+ $(window).scrollTop(scroll_target - 10);
+ return false
+})
+
+});
+</script>
+
+<div id="toc"></div>
+
+
+
+
+
+
+
+
+
+
+<h2 id="modifyresource">ModifyResource</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/the_policy_id/policies/commands/modify"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/entries/the_label/resources/thing:/the_resource_path"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"grant"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
+ </span><span class="s2">"READ"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"WRITE"</span><span class="w">
+ </span><span class="p">],</span><span class="w">
+ </span><span class="s2">"revoke"</span><span class="p">:</span><span class="w"> </span><span class="p">[]</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="modifyresourceresponse">ModifyResourceResponse</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/the_policy_id/policies/commands/modify"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/entries/the_label/resources/thing:/the_resource_path"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">204</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+
+
+ <div class="tags">
+
+ </div>
+
+</div>
+
+<hr class="shaded"/>
+
+<footer>
+ <div class="row">
+ <div class="col-lg-12 footer">
+ <div class="logo">
+ <a href="https://eclipse.org"><img src="images/eclipse_foundation_logo.svg" alt="Eclipse logo"/></a>
+ </div>
+ <p class="notice">
+ ©2020 Eclipse Ditto.
+ Site last generated: Jul 1, 2020 <br />
+ </p>
+ <div class="quickLinks">
+ <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
+ > Privacy Policy
+ </a>
+ <a href="https://www.eclipse.org/legal/termsofuse.php" target="_blank">
+ > Terms of Use
+ </a>
+ <a href="https://www.eclipse.org/legal/copyright.php" target="_blank">
+ > Copyright Agent
+ </a>
+ <a href="https://www.eclipse.org/legal" target="_blank">
+ > Legal
+ </a>
+ <a href="https://www.eclipse.org/legal/epl-2.0/" target="_blank">
+ > License
+ </a>
+ <a href="https://eclipse.org/security" target="_blank">
+ > Report a Vulnerability
+ </a>
+ </div>
+ </div>
+ </div>
+</footer>
+
+
+ </div>
+ <!-- /.row -->
+</div>
+<!-- /.container -->
+</div>
+<!-- /#main -->
+ </div>
+
+</body>
+</html>
diff --git a/1.0/protocol-examples-policies-modifyresources.html b/1.0/protocol-examples-policies-modifyresources.html
new file mode 100644
index 0000000..dd2f396
--- /dev/null
+++ b/1.0/protocol-examples-policies-modifyresources.html
@@ -0,0 +1,1560 @@
+<!DOCTYPE html>
+<html>
+<head>
+ <meta charset="utf-8">
+<meta http-equiv="X-UA-Compatible" content="IE=edge">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="description" content="">
+<meta name="keywords" content=" examples, modify resources">
+<title> Modify resources • Eclipse Ditto • a digital twin framework</title>
+
+<link rel="stylesheet" href="css/syntax.css">
+<link rel="stylesheet" type="text/css" href="//cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/modern-business.css">
+<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/customstyles.css">
+<link rel="stylesheet" href="css/boxshadowproperties.css">
+<link rel="stylesheet" href="css/theme-ditto.css">
+<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:400,700|Source+Code+Pro:300,600|Titillium+Web:400,600,700">
+
+<script src="//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.4/jquery.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/js/bootstrap.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/anchor-js/2.0.0/anchor.min.js" crossorigin="anonymous"></script>
+<script src="js/toc.js"></script>
+<script src="js/customscripts.js"></script>
+
+<script type="application/ld+json">
+{
+ "@context": "http://schema.org",
+ "@type": "Organization",
+ "url": "https://eclipse.org/ditto/",
+ "logo": "https://eclipse.org/ditto/images/ditto.svg"
+}
+</script>
+
+<link rel="icon" type="image/png" href="images/favicon-16x16.png" sizes="16x16">
+<link rel="icon" type="image/png" href="images/favicon-32x32.png" sizes="32x32">
+<link rel="icon" type="image/png" href="images/favicon-96x96.png" sizes="96x96">
+
+<link rel="alternate" type="application/rss+xml" title="Eclipse Ditto Blog" href="https://www.eclipse.org/ditto/feed.xml">
+
+<!-- Eclipse Foundation cookie consent: -->
+<link rel="stylesheet" type="text/css" href="//www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css" />
+<script src="//www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+ <script>
+ $(document).ready(function() {
+ $("#tg-sb-link").click(function() {
+ $("#tg-sb-sidebar").toggle();
+ $("#tg-sb-content").toggleClass('col-md-9');
+ $("#tg-sb-content").toggleClass('col-md-12');
+ $("#tg-sb-icon").toggleClass('fa-toggle-on');
+ $("#tg-sb-icon").toggleClass('fa-toggle-off');
+ });
+ });
+ </script>
+</head>
+
+
+<script>
+ (function(w,d,s,l,i){
+ w[l]=w[l]||[];
+ w[l].push({'gtm.start':
+ new Date().getTime(),event:'gtm.js'});
+ var f=d.getElementsByTagName(s)[0],
+ j=d.createElement(s),
+ dl=l!='dataLayer'?'&l='+l:'';
+ j.async=true;
+ j.src='https://www.googletagmanager.com/gtm.js?id='+i+dl;
+ f.parentNode.insertBefore(j,f);
+ })(window,document,'script','dataLayer','GTM-5WLCZXC');
+</script>
+
+
+
+<body>
+<!-- Navigation -->
+<nav class="navbar navbar-inverse navbar-fixed-top">
+ <div class="container topnavlinks">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-ditto-home" href="index.html"> <img src="images/ditto_allwhite_symbolonly.svg" class="ditto-navbar-symbol" alt="Home"> <img src="images/ditto_allwhite_textonly.svg" class="ditto-navbar-symbol-text" alt="Ditto"></a>
+ </div>
+ <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
+ <ul class="nav navbar-nav navbar-right">
+ <!-- toggle sidebar button -->
+ <!--<li><a id="tg-sb-link" href="#"><i id="tg-sb-icon" class="fa fa-toggle-on"></i> Nav</a></li>-->
+ <!-- entries without drop-downs appear here -->
+
+
+
+
+
+
+
+ <li><a href="blog.html">Blog</a></li>
+
+
+
+ <li><a href="intro-overview.html">Documentation</a></li>
+
+
+
+ <li><a href="http-api-doc.html">HTTP API</a></li>
+
+
+
+ <li><a href="https://ditto.eclipse.org" target="_blank">Sandbox</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">GitHub</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">GitHub examples</a></li>
+
+
+
+ <!-- entries with drop-downs appear here -->
+ <!-- conditional logic to control which topnav appears for the audience defined in the configuration file.-->
+
+
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Links<b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+
+ <li><a href="https://projects.eclipse.org/projects/iot.ditto" target="_blank">Eclipse Ditto Project</a></li>
+
+
+
+ <li><a href="https://www.eclipse.org/forums/index.php/f/364/" target="_blank">Forum</a></li>
+
+
+
+ <li><a href="https://ci.eclipse.org/ditto/" target="_blank">Jenkins</a></li>
+
+
+
+ <li><a href="https://dev.eclipse.org/mhonarc/lists/ditto-dev/" target="_blank">Mailing list archives</a></li>
+
+
+
+ <li><a href="https://gitter.im/eclipse/ditto" target="_blank">Gitter.im chat</a></li>
+
+
+ </ul>
+ </li>
+
+
+
+ <!--comment out this block if you want to hide search-->
+ <li>
+ <!--start search-->
+ <div id="search-demo-container">
+ <input type="text" id="search-input" placeholder="search...">
+ <ul id="results-container"></ul>
+ </div>
+ <script src="//cdnjs.cloudflare.com/ajax/libs/simple-jekyll-search/0.0.9/jekyll-search.js" type="text/javascript"></script>
+ <script type="text/javascript">
+ SimpleJekyllSearch.init({
+ searchInput: document.getElementById('search-input'),
+ resultsContainer: document.getElementById('results-container'),
+ dataSource: 'search.json',
+ searchResultTemplate: '<li><a href="{url}" title="Modify resources">{title}</a></li>',
+ noResultsText: 'No results found.',
+ limit: 10,
+ fuzzy: true,
+ })
+ </script>
+ <!--end search-->
+ </li>
+ </ul>
+ </div>
+ </div>
+ <!-- /.container -->
+</nav>
+
+<!-- Page Content -->
+<div class="container">
+ <div id="main">
+ <!-- Content Row -->
+ <div class="row">
+
+
+ <!-- Sidebar Column -->
+ <div class="col-md-3" id="tg-sb-sidebar">
+
+
+<ul id="mysidebar" class="nav">
+ <li class="sidebarTitle">
+ <label for="docVersion">Eclipse Ditto version:</label>
+ <div class="select-wrapper">
+ <select id="docVersion" name="docVersion">
+
+ <option value="">development</option>
+
+ <option value="1.0">1.0</option>
+
+ <option value="1.1">1.1</option>
+
+ </select>
+ </div>
+ <div id="dev-warning">
+ <div markdown="span" class="alert alert-warning" role="alert" style="font-size:0.6em"><i class="fa fa-warning"></i> <b>Important:</b> This documentation reflects the latest 'development'. You might want to choose a released version.</div>
+ </div>
+ </li>
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Introduction</a>
+ <ul>
+
+
+
+ <li><a href="intro-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="intro-digitaltwins.html">Digital twins</a></li>
+
+
+
+
+
+
+ <li><a href="intro-hello-world.html">Hello world</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Release Notes</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_100.html">1.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_090.html">0.9.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_080.html">0.8.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Milestone releases</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_100-M2.html">1.0.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_100-M1a.html">1.0.0-M1a</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M2.html">0.9.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M1.html">0.9.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M3.html">0.8.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M2.html">0.8.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M1.html">0.8.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M2.html">0.3.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M1.html">0.3.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_020-M1.html">0.2.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M3.html">0.1.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M1.html">0.1.0-M1</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Installation</a>
+ <ul>
+
+
+
+ <li><a href="installation-building.html">Building Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-running.html">Running Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-operating.html">Operating Ditto</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Basic concepts</a>
+ <ul>
+
+
+
+ <li><a href="basic-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Model entities</a>
+ <ul>
+
+
+
+ <li><a href="basic-thing.html">Thing</a></li>
+
+
+
+
+
+ <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
+
+
+
+
+
+ <li><a href="basic-feature.html">Feature</a></li>
+
+
+
+
+
+ <li><a href="basic-policy.html">Policy</a></li>
+
+
+
+
+
+ <li><a href="basic-namespaces-and-names.html">Namespaces and Names</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-auth.html">Authentication and Authorization</a></li>
+
+
+
+
+
+
+ <li><a href="basic-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="basic-signals.html">Signals</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Signal types</a>
+ <ul>
+
+
+
+ <li><a href="basic-signals-command.html">Command</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-commandresponse.html">Command response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-errorresponse.html">Error response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-event.html">Event</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-apis.html">APIs</a></li>
+
+
+
+
+
+
+ <li><a href="basic-connections.html">Connections</a></li>
+
+
+
+
+
+
+ <li><a href="basic-placeholders.html">Placeholders</a></li>
+
+
+
+
+
+
+ <li><a href="basic-changenotifications.html">Change notifications</a></li>
+
+
+
+
+
+
+ <li><a href="basic-rql.html">RQL expressions</a></li>
+
+
+
+
+
+
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
+ <li><a href="basic-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Architecture</a>
+ <ul>
+
+
+
+ <li><a href="architecture-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Services</a>
+ <ul>
+
+
+
+ <li><a href="architecture-services-policies.html">Policies</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things.html">Things</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things-search.html">Things-Search</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-connectivity.html">Connectivity</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-concierge.html">Concierge</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-gateway.html">Gateway</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>HTTP API</a>
+ <ul>
+
+
+
+ <li><a href="httpapi-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-concepts.html">Concepts</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-protocol-bindings-websocket.html">WebSocket protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-sse.html">Server sent events</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Connectivity API</a>
+ <ul>
+
+
+
+ <li><a href="connectivity-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-manage-connections.html">Manage connections</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp091.html">AMQP 0.9.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp10.html">AMQP 1.0 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-kafka2.html">Kafka 2.x protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-mapping.html">Payload mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-header-mapping.html">Header mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-tls-certificates.html">TLS certificates</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Client SDK</a>
+ <ul>
+
+
+
+ <li><a href="client-sdk-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-java.html">Java</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-javascript.html">JavaScript</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Ditto Protocol</a>
+ <ul>
+
+
+
+ <li><a href="protocol-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-twinlive.html">Twin/live channel</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification.html">Specification</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-topic.html">Protocol topic</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-things.html">Things group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-delete.html">Delete</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ search/messages</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-search.html">Search</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-messages.html">Messages</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-bindings.html">Bindings</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-examples.html">Examples</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-creatething.html">Create a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletething.html">Delete a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifything.html">Modify a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievething.html">Retrieve a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethings.html">Retrieve multiple Things</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattributes.html">Delete Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattributes.html">Modify Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattributes.html">Retrieve Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattribute.html">Create a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattribute.html">Delete a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattribute.html">Modify a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattribute.html">Retrieve a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createthingdefinition.html">Create a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletethingdefinition.html">Delete a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifythingdefinition.html">Modify a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethingdefinition.html">Retrieve a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeatures.html">Create Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeatures.html">Delete Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeatures.html">Modify Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeatures.html">Retrieve Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeature.html">Create a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeature.html">Delete a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeature.html">Modify a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeature.html">Retrieve a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdefinition.html">Create Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedefinition.html">Delete Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydefinition.html">Modify Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedefinition.html">Retrieve Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperties.html">Create Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperties.html">Delete Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperties.html">Modify Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperties.html">Retrieve Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperty.html">Create a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperty.html">Delete a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperty.html">Modify a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperty.html">Retrieve a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li class="active"><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li><a href="sandbox.html">Sandbox</a></li>
+
+
+
+
+
+ <li><a href="presentations.html">Presentations</a></li>
+
+
+
+
+
+ <li><a href="glossary.html">Glossary</a></li>
+
+
+
+
+
+ <li><a href="feedback.html">Feedback</a></li>
+
+
+
+
+
+ <p class="external">
+ <a href="#" id="collapseAll">Collapse All</a> | <a href="#" id="expandAll">Expand All</a>
+ </p>
+
+</ul>
+
+<!-- this highlights the active parent class in the sidebar. this is critical so that the parent expands when you're viewing a page. This must appear below the sidebar code above. Otherwise, if placed inside customscripts.js, the script runs before the sidebar code runs and the class never gets inserted.-->
+<script>$("li.active").parents('li').toggleClass("active");
+
+$(function() {
+ $("#dev-warning").hide();
+ changeSelectedDocVersionDropdownSelection($("#docVersion")[0]);
+ $("#docVersion").change(changeSelectedDocVersion);
+});
+
+function changeSelectedDocVersionDropdownSelection(element) {
+ var pathName = window.location.pathname;
+
+ var versionOptions = element.options;
+ for (var i = 0; i < versionOptions.length; i++) {
+ var versionValue = versionOptions[i].value;
+ if ((versionValue !== "") && pathName.startsWith("/ditto/"+versionValue+"/")) {
+ $("#docVersion").val(versionValue).change();
+ return;
+ }
+ }
+ // fallback: dev with "empty" version value:
+ $("#docVersion").val("").change();
+ $("#dev-warning").show();
+}
+function changeSelectedDocVersion() {
+ var versionValue = $('#docVersion').val();
+ var remainingPath = window.location.pathname.replace("/ditto/", "");
+ var versionMatch = remainingPath.match("([0-9].[0.9])/(.*)");
+ if (versionValue === "" && !versionMatch) {
+ // do nothing, we're already on the correct "dev" version
+ } else if (versionMatch && (versionValue === versionMatch[1])) {
+ // do nothing, we're already on the correct version
+ } else {
+ if (versionValue === "" && versionMatch) {
+ window.location.pathname = "ditto/" + versionMatch[2];
+ } else if (versionValue === "") {
+ window.location.pathname = "ditto/" + remainingPath;
+ } else if (versionMatch) {
+ window.location.pathname = "ditto/" + versionValue + "/" + versionMatch[2];
+ } else {
+ window.location.pathname = "ditto/" + versionValue + "/" + remainingPath;
+ }
+ }
+}
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Modify resources</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+
+
+
+<!-- this handles the automatic toc. use ## for subheads to auto-generate the on-page minitoc. if you use html tags, you must supply an ID for the heading element in order for it to appear in the minitoc. -->
+<script>
+$( document ).ready(function() {
+ // Handler for .ready() called.
+
+$('#toc').toc({ minimumHeaders: 0, listType: 'ul', showSpeed: 0, headers: 'h2,h3,h4' });
+
+/* this offset helps account for the space taken up by the floating toolbar. */
+$('#toc').on('click', 'a', function() {
+ var target = $(this.getAttribute('href'))
+ , scroll_target = target.offset().top
+
+ $(window).scrollTop(scroll_target - 10);
+ return false
+})
+
+});
+</script>
+
+<div id="toc"></div>
+
+
+
+
+
+
+
+
+
+
+<h2 id="modifyresources">ModifyResources</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/the_policy_id/policies/commands/modify"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/entries/the_label/resources"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"thing:/the_resource_path"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"__schemaVersion"</span><span class="p">:</span><span class="w"> </span><span class="mi">2</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"grant"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
+ </span><span class="s2">"READ"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"WRITE"</span><span class="w">
+ </span><span class="p">],</span><span class="w">
+ </span><span class="s2">"revoke"</span><span class="p">:</span><span class="w"> </span><span class="p">[]</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="modifyresourcesresponse">ModifyResourcesResponse</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/the_policy_id/policies/commands/modify"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/entries/the_label/resources"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">204</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+
+
+ <div class="tags">
+
+ </div>
+
+</div>
+
+<hr class="shaded"/>
+
+<footer>
+ <div class="row">
+ <div class="col-lg-12 footer">
+ <div class="logo">
+ <a href="https://eclipse.org"><img src="images/eclipse_foundation_logo.svg" alt="Eclipse logo"/></a>
+ </div>
+ <p class="notice">
+ ©2020 Eclipse Ditto.
+ Site last generated: Jul 1, 2020 <br />
+ </p>
+ <div class="quickLinks">
+ <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
+ > Privacy Policy
+ </a>
+ <a href="https://www.eclipse.org/legal/termsofuse.php" target="_blank">
+ > Terms of Use
+ </a>
+ <a href="https://www.eclipse.org/legal/copyright.php" target="_blank">
+ > Copyright Agent
+ </a>
+ <a href="https://www.eclipse.org/legal" target="_blank">
+ > Legal
+ </a>
+ <a href="https://www.eclipse.org/legal/epl-2.0/" target="_blank">
+ > License
+ </a>
+ <a href="https://eclipse.org/security" target="_blank">
+ > Report a Vulnerability
+ </a>
+ </div>
+ </div>
+ </div>
+</footer>
+
+
+ </div>
+ <!-- /.row -->
+</div>
+<!-- /.container -->
+</div>
+<!-- /#main -->
+ </div>
+
+</body>
+</html>
diff --git a/1.0/protocol-examples-policies-modifysubject.html b/1.0/protocol-examples-policies-modifysubject.html
new file mode 100644
index 0000000..f949dab
--- /dev/null
+++ b/1.0/protocol-examples-policies-modifysubject.html
@@ -0,0 +1,1553 @@
+<!DOCTYPE html>
+<html>
+<head>
+ <meta charset="utf-8">
+<meta http-equiv="X-UA-Compatible" content="IE=edge">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="description" content="">
+<meta name="keywords" content=" examples, modify subject">
+<title> Modify a subject • Eclipse Ditto • a digital twin framework</title>
+
+<link rel="stylesheet" href="css/syntax.css">
+<link rel="stylesheet" type="text/css" href="//cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/modern-business.css">
+<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/customstyles.css">
+<link rel="stylesheet" href="css/boxshadowproperties.css">
+<link rel="stylesheet" href="css/theme-ditto.css">
+<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:400,700|Source+Code+Pro:300,600|Titillium+Web:400,600,700">
+
+<script src="//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.4/jquery.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/js/bootstrap.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/anchor-js/2.0.0/anchor.min.js" crossorigin="anonymous"></script>
+<script src="js/toc.js"></script>
+<script src="js/customscripts.js"></script>
+
+<script type="application/ld+json">
+{
+ "@context": "http://schema.org",
+ "@type": "Organization",
+ "url": "https://eclipse.org/ditto/",
+ "logo": "https://eclipse.org/ditto/images/ditto.svg"
+}
+</script>
+
+<link rel="icon" type="image/png" href="images/favicon-16x16.png" sizes="16x16">
+<link rel="icon" type="image/png" href="images/favicon-32x32.png" sizes="32x32">
+<link rel="icon" type="image/png" href="images/favicon-96x96.png" sizes="96x96">
+
+<link rel="alternate" type="application/rss+xml" title="Eclipse Ditto Blog" href="https://www.eclipse.org/ditto/feed.xml">
+
+<!-- Eclipse Foundation cookie consent: -->
+<link rel="stylesheet" type="text/css" href="//www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css" />
+<script src="//www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+ <script>
+ $(document).ready(function() {
+ $("#tg-sb-link").click(function() {
+ $("#tg-sb-sidebar").toggle();
+ $("#tg-sb-content").toggleClass('col-md-9');
+ $("#tg-sb-content").toggleClass('col-md-12');
+ $("#tg-sb-icon").toggleClass('fa-toggle-on');
+ $("#tg-sb-icon").toggleClass('fa-toggle-off');
+ });
+ });
+ </script>
+</head>
+
+
+<script>
+ (function(w,d,s,l,i){
+ w[l]=w[l]||[];
+ w[l].push({'gtm.start':
+ new Date().getTime(),event:'gtm.js'});
+ var f=d.getElementsByTagName(s)[0],
+ j=d.createElement(s),
+ dl=l!='dataLayer'?'&l='+l:'';
+ j.async=true;
+ j.src='https://www.googletagmanager.com/gtm.js?id='+i+dl;
+ f.parentNode.insertBefore(j,f);
+ })(window,document,'script','dataLayer','GTM-5WLCZXC');
+</script>
+
+
+
+<body>
+<!-- Navigation -->
+<nav class="navbar navbar-inverse navbar-fixed-top">
+ <div class="container topnavlinks">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-ditto-home" href="index.html"> <img src="images/ditto_allwhite_symbolonly.svg" class="ditto-navbar-symbol" alt="Home"> <img src="images/ditto_allwhite_textonly.svg" class="ditto-navbar-symbol-text" alt="Ditto"></a>
+ </div>
+ <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
+ <ul class="nav navbar-nav navbar-right">
+ <!-- toggle sidebar button -->
+ <!--<li><a id="tg-sb-link" href="#"><i id="tg-sb-icon" class="fa fa-toggle-on"></i> Nav</a></li>-->
+ <!-- entries without drop-downs appear here -->
+
+
+
+
+
+
+
+ <li><a href="blog.html">Blog</a></li>
+
+
+
+ <li><a href="intro-overview.html">Documentation</a></li>
+
+
+
+ <li><a href="http-api-doc.html">HTTP API</a></li>
+
+
+
+ <li><a href="https://ditto.eclipse.org" target="_blank">Sandbox</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">GitHub</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">GitHub examples</a></li>
+
+
+
+ <!-- entries with drop-downs appear here -->
+ <!-- conditional logic to control which topnav appears for the audience defined in the configuration file.-->
+
+
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Links<b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+
+ <li><a href="https://projects.eclipse.org/projects/iot.ditto" target="_blank">Eclipse Ditto Project</a></li>
+
+
+
+ <li><a href="https://www.eclipse.org/forums/index.php/f/364/" target="_blank">Forum</a></li>
+
+
+
+ <li><a href="https://ci.eclipse.org/ditto/" target="_blank">Jenkins</a></li>
+
+
+
+ <li><a href="https://dev.eclipse.org/mhonarc/lists/ditto-dev/" target="_blank">Mailing list archives</a></li>
+
+
+
+ <li><a href="https://gitter.im/eclipse/ditto" target="_blank">Gitter.im chat</a></li>
+
+
+ </ul>
+ </li>
+
+
+
+ <!--comment out this block if you want to hide search-->
+ <li>
+ <!--start search-->
+ <div id="search-demo-container">
+ <input type="text" id="search-input" placeholder="search...">
+ <ul id="results-container"></ul>
+ </div>
+ <script src="//cdnjs.cloudflare.com/ajax/libs/simple-jekyll-search/0.0.9/jekyll-search.js" type="text/javascript"></script>
+ <script type="text/javascript">
+ SimpleJekyllSearch.init({
+ searchInput: document.getElementById('search-input'),
+ resultsContainer: document.getElementById('results-container'),
+ dataSource: 'search.json',
+ searchResultTemplate: '<li><a href="{url}" title="Modify a subject">{title}</a></li>',
+ noResultsText: 'No results found.',
+ limit: 10,
+ fuzzy: true,
+ })
+ </script>
+ <!--end search-->
+ </li>
+ </ul>
+ </div>
+ </div>
+ <!-- /.container -->
+</nav>
+
+<!-- Page Content -->
+<div class="container">
+ <div id="main">
+ <!-- Content Row -->
+ <div class="row">
+
+
+ <!-- Sidebar Column -->
+ <div class="col-md-3" id="tg-sb-sidebar">
+
+
+<ul id="mysidebar" class="nav">
+ <li class="sidebarTitle">
+ <label for="docVersion">Eclipse Ditto version:</label>
+ <div class="select-wrapper">
+ <select id="docVersion" name="docVersion">
+
+ <option value="">development</option>
+
+ <option value="1.0">1.0</option>
+
+ <option value="1.1">1.1</option>
+
+ </select>
+ </div>
+ <div id="dev-warning">
+ <div markdown="span" class="alert alert-warning" role="alert" style="font-size:0.6em"><i class="fa fa-warning"></i> <b>Important:</b> This documentation reflects the latest 'development'. You might want to choose a released version.</div>
+ </div>
+ </li>
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Introduction</a>
+ <ul>
+
+
+
+ <li><a href="intro-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="intro-digitaltwins.html">Digital twins</a></li>
+
+
+
+
+
+
+ <li><a href="intro-hello-world.html">Hello world</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Release Notes</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_100.html">1.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_090.html">0.9.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_080.html">0.8.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Milestone releases</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_100-M2.html">1.0.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_100-M1a.html">1.0.0-M1a</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M2.html">0.9.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M1.html">0.9.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M3.html">0.8.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M2.html">0.8.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M1.html">0.8.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M2.html">0.3.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M1.html">0.3.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_020-M1.html">0.2.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M3.html">0.1.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M1.html">0.1.0-M1</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Installation</a>
+ <ul>
+
+
+
+ <li><a href="installation-building.html">Building Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-running.html">Running Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-operating.html">Operating Ditto</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Basic concepts</a>
+ <ul>
+
+
+
+ <li><a href="basic-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Model entities</a>
+ <ul>
+
+
+
+ <li><a href="basic-thing.html">Thing</a></li>
+
+
+
+
+
+ <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
+
+
+
+
+
+ <li><a href="basic-feature.html">Feature</a></li>
+
+
+
+
+
+ <li><a href="basic-policy.html">Policy</a></li>
+
+
+
+
+
+ <li><a href="basic-namespaces-and-names.html">Namespaces and Names</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-auth.html">Authentication and Authorization</a></li>
+
+
+
+
+
+
+ <li><a href="basic-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="basic-signals.html">Signals</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Signal types</a>
+ <ul>
+
+
+
+ <li><a href="basic-signals-command.html">Command</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-commandresponse.html">Command response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-errorresponse.html">Error response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-event.html">Event</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-apis.html">APIs</a></li>
+
+
+
+
+
+
+ <li><a href="basic-connections.html">Connections</a></li>
+
+
+
+
+
+
+ <li><a href="basic-placeholders.html">Placeholders</a></li>
+
+
+
+
+
+
+ <li><a href="basic-changenotifications.html">Change notifications</a></li>
+
+
+
+
+
+
+ <li><a href="basic-rql.html">RQL expressions</a></li>
+
+
+
+
+
+
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
+ <li><a href="basic-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Architecture</a>
+ <ul>
+
+
+
+ <li><a href="architecture-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Services</a>
+ <ul>
+
+
+
+ <li><a href="architecture-services-policies.html">Policies</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things.html">Things</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things-search.html">Things-Search</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-connectivity.html">Connectivity</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-concierge.html">Concierge</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-gateway.html">Gateway</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>HTTP API</a>
+ <ul>
+
+
+
+ <li><a href="httpapi-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-concepts.html">Concepts</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-protocol-bindings-websocket.html">WebSocket protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-sse.html">Server sent events</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Connectivity API</a>
+ <ul>
+
+
+
+ <li><a href="connectivity-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-manage-connections.html">Manage connections</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp091.html">AMQP 0.9.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp10.html">AMQP 1.0 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-kafka2.html">Kafka 2.x protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-mapping.html">Payload mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-header-mapping.html">Header mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-tls-certificates.html">TLS certificates</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Client SDK</a>
+ <ul>
+
+
+
+ <li><a href="client-sdk-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-java.html">Java</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-javascript.html">JavaScript</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Ditto Protocol</a>
+ <ul>
+
+
+
+ <li><a href="protocol-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-twinlive.html">Twin/live channel</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification.html">Specification</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-topic.html">Protocol topic</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-things.html">Things group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-delete.html">Delete</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ search/messages</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-search.html">Search</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-messages.html">Messages</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-bindings.html">Bindings</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-examples.html">Examples</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-creatething.html">Create a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletething.html">Delete a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifything.html">Modify a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievething.html">Retrieve a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethings.html">Retrieve multiple Things</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattributes.html">Delete Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattributes.html">Modify Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattributes.html">Retrieve Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattribute.html">Create a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattribute.html">Delete a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattribute.html">Modify a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattribute.html">Retrieve a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createthingdefinition.html">Create a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletethingdefinition.html">Delete a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifythingdefinition.html">Modify a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethingdefinition.html">Retrieve a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeatures.html">Create Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeatures.html">Delete Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeatures.html">Modify Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeatures.html">Retrieve Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeature.html">Create a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeature.html">Delete a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeature.html">Modify a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeature.html">Retrieve a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdefinition.html">Create Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedefinition.html">Delete Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydefinition.html">Modify Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedefinition.html">Retrieve Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperties.html">Create Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperties.html">Delete Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperties.html">Modify Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperties.html">Retrieve Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperty.html">Create a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperty.html">Delete a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperty.html">Modify a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperty.html">Retrieve a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li class="active"><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li><a href="sandbox.html">Sandbox</a></li>
+
+
+
+
+
+ <li><a href="presentations.html">Presentations</a></li>
+
+
+
+
+
+ <li><a href="glossary.html">Glossary</a></li>
+
+
+
+
+
+ <li><a href="feedback.html">Feedback</a></li>
+
+
+
+
+
+ <p class="external">
+ <a href="#" id="collapseAll">Collapse All</a> | <a href="#" id="expandAll">Expand All</a>
+ </p>
+
+</ul>
+
+<!-- this highlights the active parent class in the sidebar. this is critical so that the parent expands when you're viewing a page. This must appear below the sidebar code above. Otherwise, if placed inside customscripts.js, the script runs before the sidebar code runs and the class never gets inserted.-->
+<script>$("li.active").parents('li').toggleClass("active");
+
+$(function() {
+ $("#dev-warning").hide();
+ changeSelectedDocVersionDropdownSelection($("#docVersion")[0]);
+ $("#docVersion").change(changeSelectedDocVersion);
+});
+
+function changeSelectedDocVersionDropdownSelection(element) {
+ var pathName = window.location.pathname;
+
+ var versionOptions = element.options;
+ for (var i = 0; i < versionOptions.length; i++) {
+ var versionValue = versionOptions[i].value;
+ if ((versionValue !== "") && pathName.startsWith("/ditto/"+versionValue+"/")) {
+ $("#docVersion").val(versionValue).change();
+ return;
+ }
+ }
+ // fallback: dev with "empty" version value:
+ $("#docVersion").val("").change();
+ $("#dev-warning").show();
+}
+function changeSelectedDocVersion() {
+ var versionValue = $('#docVersion').val();
+ var remainingPath = window.location.pathname.replace("/ditto/", "");
+ var versionMatch = remainingPath.match("([0-9].[0.9])/(.*)");
+ if (versionValue === "" && !versionMatch) {
+ // do nothing, we're already on the correct "dev" version
+ } else if (versionMatch && (versionValue === versionMatch[1])) {
+ // do nothing, we're already on the correct version
+ } else {
+ if (versionValue === "" && versionMatch) {
+ window.location.pathname = "ditto/" + versionMatch[2];
+ } else if (versionValue === "") {
+ window.location.pathname = "ditto/" + remainingPath;
+ } else if (versionMatch) {
+ window.location.pathname = "ditto/" + versionValue + "/" + versionMatch[2];
+ } else {
+ window.location.pathname = "ditto/" + versionValue + "/" + remainingPath;
+ }
+ }
+}
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Modify a subject</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+
+
+
+<!-- this handles the automatic toc. use ## for subheads to auto-generate the on-page minitoc. if you use html tags, you must supply an ID for the heading element in order for it to appear in the minitoc. -->
+<script>
+$( document ).ready(function() {
+ // Handler for .ready() called.
+
+$('#toc').toc({ minimumHeaders: 0, listType: 'ul', showSpeed: 0, headers: 'h2,h3,h4' });
+
+/* this offset helps account for the space taken up by the floating toolbar. */
+$('#toc').on('click', 'a', function() {
+ var target = $(this.getAttribute('href'))
+ , scroll_target = target.offset().top
+
+ $(window).scrollTop(scroll_target - 10);
+ return false
+})
+
+});
+</script>
+
+<div id="toc"></div>
+
+
+
+
+
+
+
+
+
+
+<h2 id="modifysubject">ModifySubject</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/the_policy_id/policies/commands/modify"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/entries/the_label/subjects/google:the_subjectid"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"yourSubjectTypeDescription"</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="modifysubjectresponse">ModifySubjectResponse</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/the_policy_id/policies/commands/modify"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/entries/the_label/subjects/google:the_subjectid"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">204</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+
+
+ <div class="tags">
+
+ </div>
+
+</div>
+
+<hr class="shaded"/>
+
+<footer>
+ <div class="row">
+ <div class="col-lg-12 footer">
+ <div class="logo">
+ <a href="https://eclipse.org"><img src="images/eclipse_foundation_logo.svg" alt="Eclipse logo"/></a>
+ </div>
+ <p class="notice">
+ ©2020 Eclipse Ditto.
+ Site last generated: Jul 1, 2020 <br />
+ </p>
+ <div class="quickLinks">
+ <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
+ > Privacy Policy
+ </a>
+ <a href="https://www.eclipse.org/legal/termsofuse.php" target="_blank">
+ > Terms of Use
+ </a>
+ <a href="https://www.eclipse.org/legal/copyright.php" target="_blank">
+ > Copyright Agent
+ </a>
+ <a href="https://www.eclipse.org/legal" target="_blank">
+ > Legal
+ </a>
+ <a href="https://www.eclipse.org/legal/epl-2.0/" target="_blank">
+ > License
+ </a>
+ <a href="https://eclipse.org/security" target="_blank">
+ > Report a Vulnerability
+ </a>
+ </div>
+ </div>
+ </div>
+</footer>
+
+
+ </div>
+ <!-- /.row -->
+</div>
+<!-- /.container -->
+</div>
+<!-- /#main -->
+ </div>
+
+</body>
+</html>
diff --git a/1.0/protocol-examples-policies-modifysubjects.html b/1.0/protocol-examples-policies-modifysubjects.html
new file mode 100644
index 0000000..196631d
--- /dev/null
+++ b/1.0/protocol-examples-policies-modifysubjects.html
@@ -0,0 +1,1556 @@
+<!DOCTYPE html>
+<html>
+<head>
+ <meta charset="utf-8">
+<meta http-equiv="X-UA-Compatible" content="IE=edge">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="description" content="">
+<meta name="keywords" content=" examples, modify subjects">
+<title> Modify subjects • Eclipse Ditto • a digital twin framework</title>
+
+<link rel="stylesheet" href="css/syntax.css">
+<link rel="stylesheet" type="text/css" href="//cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/modern-business.css">
+<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/customstyles.css">
+<link rel="stylesheet" href="css/boxshadowproperties.css">
+<link rel="stylesheet" href="css/theme-ditto.css">
+<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:400,700|Source+Code+Pro:300,600|Titillium+Web:400,600,700">
+
+<script src="//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.4/jquery.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/js/bootstrap.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/anchor-js/2.0.0/anchor.min.js" crossorigin="anonymous"></script>
+<script src="js/toc.js"></script>
+<script src="js/customscripts.js"></script>
+
+<script type="application/ld+json">
+{
+ "@context": "http://schema.org",
+ "@type": "Organization",
+ "url": "https://eclipse.org/ditto/",
+ "logo": "https://eclipse.org/ditto/images/ditto.svg"
+}
+</script>
+
+<link rel="icon" type="image/png" href="images/favicon-16x16.png" sizes="16x16">
+<link rel="icon" type="image/png" href="images/favicon-32x32.png" sizes="32x32">
+<link rel="icon" type="image/png" href="images/favicon-96x96.png" sizes="96x96">
+
+<link rel="alternate" type="application/rss+xml" title="Eclipse Ditto Blog" href="https://www.eclipse.org/ditto/feed.xml">
+
+<!-- Eclipse Foundation cookie consent: -->
+<link rel="stylesheet" type="text/css" href="//www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css" />
+<script src="//www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+ <script>
+ $(document).ready(function() {
+ $("#tg-sb-link").click(function() {
+ $("#tg-sb-sidebar").toggle();
+ $("#tg-sb-content").toggleClass('col-md-9');
+ $("#tg-sb-content").toggleClass('col-md-12');
+ $("#tg-sb-icon").toggleClass('fa-toggle-on');
+ $("#tg-sb-icon").toggleClass('fa-toggle-off');
+ });
+ });
+ </script>
+</head>
+
+
+<script>
+ (function(w,d,s,l,i){
+ w[l]=w[l]||[];
+ w[l].push({'gtm.start':
+ new Date().getTime(),event:'gtm.js'});
+ var f=d.getElementsByTagName(s)[0],
+ j=d.createElement(s),
+ dl=l!='dataLayer'?'&l='+l:'';
+ j.async=true;
+ j.src='https://www.googletagmanager.com/gtm.js?id='+i+dl;
+ f.parentNode.insertBefore(j,f);
+ })(window,document,'script','dataLayer','GTM-5WLCZXC');
+</script>
+
+
+
+<body>
+<!-- Navigation -->
+<nav class="navbar navbar-inverse navbar-fixed-top">
+ <div class="container topnavlinks">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-ditto-home" href="index.html"> <img src="images/ditto_allwhite_symbolonly.svg" class="ditto-navbar-symbol" alt="Home"> <img src="images/ditto_allwhite_textonly.svg" class="ditto-navbar-symbol-text" alt="Ditto"></a>
+ </div>
+ <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
+ <ul class="nav navbar-nav navbar-right">
+ <!-- toggle sidebar button -->
+ <!--<li><a id="tg-sb-link" href="#"><i id="tg-sb-icon" class="fa fa-toggle-on"></i> Nav</a></li>-->
+ <!-- entries without drop-downs appear here -->
+
+
+
+
+
+
+
+ <li><a href="blog.html">Blog</a></li>
+
+
+
+ <li><a href="intro-overview.html">Documentation</a></li>
+
+
+
+ <li><a href="http-api-doc.html">HTTP API</a></li>
+
+
+
+ <li><a href="https://ditto.eclipse.org" target="_blank">Sandbox</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">GitHub</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">GitHub examples</a></li>
+
+
+
+ <!-- entries with drop-downs appear here -->
+ <!-- conditional logic to control which topnav appears for the audience defined in the configuration file.-->
+
+
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Links<b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+
+ <li><a href="https://projects.eclipse.org/projects/iot.ditto" target="_blank">Eclipse Ditto Project</a></li>
+
+
+
+ <li><a href="https://www.eclipse.org/forums/index.php/f/364/" target="_blank">Forum</a></li>
+
+
+
+ <li><a href="https://ci.eclipse.org/ditto/" target="_blank">Jenkins</a></li>
+
+
+
+ <li><a href="https://dev.eclipse.org/mhonarc/lists/ditto-dev/" target="_blank">Mailing list archives</a></li>
+
+
+
+ <li><a href="https://gitter.im/eclipse/ditto" target="_blank">Gitter.im chat</a></li>
+
+
+ </ul>
+ </li>
+
+
+
+ <!--comment out this block if you want to hide search-->
+ <li>
+ <!--start search-->
+ <div id="search-demo-container">
+ <input type="text" id="search-input" placeholder="search...">
+ <ul id="results-container"></ul>
+ </div>
+ <script src="//cdnjs.cloudflare.com/ajax/libs/simple-jekyll-search/0.0.9/jekyll-search.js" type="text/javascript"></script>
+ <script type="text/javascript">
+ SimpleJekyllSearch.init({
+ searchInput: document.getElementById('search-input'),
+ resultsContainer: document.getElementById('results-container'),
+ dataSource: 'search.json',
+ searchResultTemplate: '<li><a href="{url}" title="Modify subjects">{title}</a></li>',
+ noResultsText: 'No results found.',
+ limit: 10,
+ fuzzy: true,
+ })
+ </script>
+ <!--end search-->
+ </li>
+ </ul>
+ </div>
+ </div>
+ <!-- /.container -->
+</nav>
+
+<!-- Page Content -->
+<div class="container">
+ <div id="main">
+ <!-- Content Row -->
+ <div class="row">
+
+
+ <!-- Sidebar Column -->
+ <div class="col-md-3" id="tg-sb-sidebar">
+
+
+<ul id="mysidebar" class="nav">
+ <li class="sidebarTitle">
+ <label for="docVersion">Eclipse Ditto version:</label>
+ <div class="select-wrapper">
+ <select id="docVersion" name="docVersion">
+
+ <option value="">development</option>
+
+ <option value="1.0">1.0</option>
+
+ <option value="1.1">1.1</option>
+
+ </select>
+ </div>
+ <div id="dev-warning">
+ <div markdown="span" class="alert alert-warning" role="alert" style="font-size:0.6em"><i class="fa fa-warning"></i> <b>Important:</b> This documentation reflects the latest 'development'. You might want to choose a released version.</div>
+ </div>
+ </li>
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Introduction</a>
+ <ul>
+
+
+
+ <li><a href="intro-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="intro-digitaltwins.html">Digital twins</a></li>
+
+
+
+
+
+
+ <li><a href="intro-hello-world.html">Hello world</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Release Notes</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_100.html">1.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_090.html">0.9.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_080.html">0.8.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Milestone releases</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_100-M2.html">1.0.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_100-M1a.html">1.0.0-M1a</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M2.html">0.9.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M1.html">0.9.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M3.html">0.8.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M2.html">0.8.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M1.html">0.8.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M2.html">0.3.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M1.html">0.3.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_020-M1.html">0.2.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M3.html">0.1.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M1.html">0.1.0-M1</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Installation</a>
+ <ul>
+
+
+
+ <li><a href="installation-building.html">Building Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-running.html">Running Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-operating.html">Operating Ditto</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Basic concepts</a>
+ <ul>
+
+
+
+ <li><a href="basic-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Model entities</a>
+ <ul>
+
+
+
+ <li><a href="basic-thing.html">Thing</a></li>
+
+
+
+
+
+ <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
+
+
+
+
+
+ <li><a href="basic-feature.html">Feature</a></li>
+
+
+
+
+
+ <li><a href="basic-policy.html">Policy</a></li>
+
+
+
+
+
+ <li><a href="basic-namespaces-and-names.html">Namespaces and Names</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-auth.html">Authentication and Authorization</a></li>
+
+
+
+
+
+
+ <li><a href="basic-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="basic-signals.html">Signals</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Signal types</a>
+ <ul>
+
+
+
+ <li><a href="basic-signals-command.html">Command</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-commandresponse.html">Command response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-errorresponse.html">Error response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-event.html">Event</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-apis.html">APIs</a></li>
+
+
+
+
+
+
+ <li><a href="basic-connections.html">Connections</a></li>
+
+
+
+
+
+
+ <li><a href="basic-placeholders.html">Placeholders</a></li>
+
+
+
+
+
+
+ <li><a href="basic-changenotifications.html">Change notifications</a></li>
+
+
+
+
+
+
+ <li><a href="basic-rql.html">RQL expressions</a></li>
+
+
+
+
+
+
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
+ <li><a href="basic-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Architecture</a>
+ <ul>
+
+
+
+ <li><a href="architecture-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Services</a>
+ <ul>
+
+
+
+ <li><a href="architecture-services-policies.html">Policies</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things.html">Things</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things-search.html">Things-Search</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-connectivity.html">Connectivity</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-concierge.html">Concierge</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-gateway.html">Gateway</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>HTTP API</a>
+ <ul>
+
+
+
+ <li><a href="httpapi-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-concepts.html">Concepts</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-protocol-bindings-websocket.html">WebSocket protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-sse.html">Server sent events</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Connectivity API</a>
+ <ul>
+
+
+
+ <li><a href="connectivity-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-manage-connections.html">Manage connections</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp091.html">AMQP 0.9.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp10.html">AMQP 1.0 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-kafka2.html">Kafka 2.x protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-mapping.html">Payload mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-header-mapping.html">Header mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-tls-certificates.html">TLS certificates</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Client SDK</a>
+ <ul>
+
+
+
+ <li><a href="client-sdk-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-java.html">Java</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-javascript.html">JavaScript</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Ditto Protocol</a>
+ <ul>
+
+
+
+ <li><a href="protocol-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-twinlive.html">Twin/live channel</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification.html">Specification</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-topic.html">Protocol topic</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-things.html">Things group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-delete.html">Delete</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ search/messages</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-search.html">Search</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-messages.html">Messages</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-bindings.html">Bindings</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-examples.html">Examples</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-creatething.html">Create a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletething.html">Delete a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifything.html">Modify a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievething.html">Retrieve a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethings.html">Retrieve multiple Things</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattributes.html">Delete Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattributes.html">Modify Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattributes.html">Retrieve Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattribute.html">Create a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattribute.html">Delete a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattribute.html">Modify a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattribute.html">Retrieve a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createthingdefinition.html">Create a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletethingdefinition.html">Delete a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifythingdefinition.html">Modify a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethingdefinition.html">Retrieve a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeatures.html">Create Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeatures.html">Delete Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeatures.html">Modify Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeatures.html">Retrieve Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeature.html">Create a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeature.html">Delete a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeature.html">Modify a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeature.html">Retrieve a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdefinition.html">Create Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedefinition.html">Delete Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydefinition.html">Modify Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedefinition.html">Retrieve Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperties.html">Create Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperties.html">Delete Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperties.html">Modify Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperties.html">Retrieve Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperty.html">Create a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperty.html">Delete a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperty.html">Modify a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperty.html">Retrieve a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li class="active"><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li><a href="sandbox.html">Sandbox</a></li>
+
+
+
+
+
+ <li><a href="presentations.html">Presentations</a></li>
+
+
+
+
+
+ <li><a href="glossary.html">Glossary</a></li>
+
+
+
+
+
+ <li><a href="feedback.html">Feedback</a></li>
+
+
+
+
+
+ <p class="external">
+ <a href="#" id="collapseAll">Collapse All</a> | <a href="#" id="expandAll">Expand All</a>
+ </p>
+
+</ul>
+
+<!-- this highlights the active parent class in the sidebar. this is critical so that the parent expands when you're viewing a page. This must appear below the sidebar code above. Otherwise, if placed inside customscripts.js, the script runs before the sidebar code runs and the class never gets inserted.-->
+<script>$("li.active").parents('li').toggleClass("active");
+
+$(function() {
+ $("#dev-warning").hide();
+ changeSelectedDocVersionDropdownSelection($("#docVersion")[0]);
+ $("#docVersion").change(changeSelectedDocVersion);
+});
+
+function changeSelectedDocVersionDropdownSelection(element) {
+ var pathName = window.location.pathname;
+
+ var versionOptions = element.options;
+ for (var i = 0; i < versionOptions.length; i++) {
+ var versionValue = versionOptions[i].value;
+ if ((versionValue !== "") && pathName.startsWith("/ditto/"+versionValue+"/")) {
+ $("#docVersion").val(versionValue).change();
+ return;
+ }
+ }
+ // fallback: dev with "empty" version value:
+ $("#docVersion").val("").change();
+ $("#dev-warning").show();
+}
+function changeSelectedDocVersion() {
+ var versionValue = $('#docVersion').val();
+ var remainingPath = window.location.pathname.replace("/ditto/", "");
+ var versionMatch = remainingPath.match("([0-9].[0.9])/(.*)");
+ if (versionValue === "" && !versionMatch) {
+ // do nothing, we're already on the correct "dev" version
+ } else if (versionMatch && (versionValue === versionMatch[1])) {
+ // do nothing, we're already on the correct version
+ } else {
+ if (versionValue === "" && versionMatch) {
+ window.location.pathname = "ditto/" + versionMatch[2];
+ } else if (versionValue === "") {
+ window.location.pathname = "ditto/" + remainingPath;
+ } else if (versionMatch) {
+ window.location.pathname = "ditto/" + versionValue + "/" + versionMatch[2];
+ } else {
+ window.location.pathname = "ditto/" + versionValue + "/" + remainingPath;
+ }
+ }
+}
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Modify subjects</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+
+
+
+<!-- this handles the automatic toc. use ## for subheads to auto-generate the on-page minitoc. if you use html tags, you must supply an ID for the heading element in order for it to appear in the minitoc. -->
+<script>
+$( document ).ready(function() {
+ // Handler for .ready() called.
+
+$('#toc').toc({ minimumHeaders: 0, listType: 'ul', showSpeed: 0, headers: 'h2,h3,h4' });
+
+/* this offset helps account for the space taken up by the floating toolbar. */
+$('#toc').on('click', 'a', function() {
+ var target = $(this.getAttribute('href'))
+ , scroll_target = target.offset().top
+
+ $(window).scrollTop(scroll_target - 10);
+ return false
+})
+
+});
+</script>
+
+<div id="toc"></div>
+
+
+
+
+
+
+
+
+
+
+<h2 id="modifysubjects">ModifySubjects</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/the_policy_id/policies/commands/modify"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/entries/the_label/subjects"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"google:the_subjectid"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"__schemaVersion"</span><span class="p">:</span><span class="w"> </span><span class="mi">2</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"yourSubjectTypeDescription"</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="modifysubjectsresponse">ModifySubjectsResponse</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/the_policy_id/policies/commands/modify"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/entries/the_label/subjects"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">204</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+
+
+ <div class="tags">
+
+ </div>
+
+</div>
+
+<hr class="shaded"/>
+
+<footer>
+ <div class="row">
+ <div class="col-lg-12 footer">
+ <div class="logo">
+ <a href="https://eclipse.org"><img src="images/eclipse_foundation_logo.svg" alt="Eclipse logo"/></a>
+ </div>
+ <p class="notice">
+ ©2020 Eclipse Ditto.
+ Site last generated: Jul 1, 2020 <br />
+ </p>
+ <div class="quickLinks">
+ <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
+ > Privacy Policy
+ </a>
+ <a href="https://www.eclipse.org/legal/termsofuse.php" target="_blank">
+ > Terms of Use
+ </a>
+ <a href="https://www.eclipse.org/legal/copyright.php" target="_blank">
+ > Copyright Agent
+ </a>
+ <a href="https://www.eclipse.org/legal" target="_blank">
+ > Legal
+ </a>
+ <a href="https://www.eclipse.org/legal/epl-2.0/" target="_blank">
+ > License
+ </a>
+ <a href="https://eclipse.org/security" target="_blank">
+ > Report a Vulnerability
+ </a>
+ </div>
+ </div>
+ </div>
+</footer>
+
+
+ </div>
+ <!-- /.row -->
+</div>
+<!-- /.container -->
+</div>
+<!-- /#main -->
+ </div>
+
+</body>
+</html>
diff --git a/1.0/protocol-examples-policies-retrievepolicy.html b/1.0/protocol-examples-policies-retrievepolicy.html
new file mode 100644
index 0000000..5539c79
--- /dev/null
+++ b/1.0/protocol-examples-policies-retrievepolicy.html
@@ -0,0 +1,1571 @@
+<!DOCTYPE html>
+<html>
+<head>
+ <meta charset="utf-8">
+<meta http-equiv="X-UA-Compatible" content="IE=edge">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="description" content="">
+<meta name="keywords" content=" examples, retrieve policy">
+<title> Retrieve a Policy • Eclipse Ditto • a digital twin framework</title>
+
+<link rel="stylesheet" href="css/syntax.css">
+<link rel="stylesheet" type="text/css" href="//cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/modern-business.css">
+<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/customstyles.css">
+<link rel="stylesheet" href="css/boxshadowproperties.css">
+<link rel="stylesheet" href="css/theme-ditto.css">
+<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:400,700|Source+Code+Pro:300,600|Titillium+Web:400,600,700">
+
+<script src="//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.4/jquery.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/js/bootstrap.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/anchor-js/2.0.0/anchor.min.js" crossorigin="anonymous"></script>
+<script src="js/toc.js"></script>
+<script src="js/customscripts.js"></script>
+
+<script type="application/ld+json">
+{
+ "@context": "http://schema.org",
+ "@type": "Organization",
+ "url": "https://eclipse.org/ditto/",
+ "logo": "https://eclipse.org/ditto/images/ditto.svg"
+}
+</script>
+
+<link rel="icon" type="image/png" href="images/favicon-16x16.png" sizes="16x16">
+<link rel="icon" type="image/png" href="images/favicon-32x32.png" sizes="32x32">
+<link rel="icon" type="image/png" href="images/favicon-96x96.png" sizes="96x96">
+
+<link rel="alternate" type="application/rss+xml" title="Eclipse Ditto Blog" href="https://www.eclipse.org/ditto/feed.xml">
+
+<!-- Eclipse Foundation cookie consent: -->
+<link rel="stylesheet" type="text/css" href="//www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css" />
+<script src="//www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+ <script>
+ $(document).ready(function() {
+ $("#tg-sb-link").click(function() {
+ $("#tg-sb-sidebar").toggle();
+ $("#tg-sb-content").toggleClass('col-md-9');
+ $("#tg-sb-content").toggleClass('col-md-12');
+ $("#tg-sb-icon").toggleClass('fa-toggle-on');
+ $("#tg-sb-icon").toggleClass('fa-toggle-off');
+ });
+ });
+ </script>
+</head>
+
+
+<script>
+ (function(w,d,s,l,i){
+ w[l]=w[l]||[];
+ w[l].push({'gtm.start':
+ new Date().getTime(),event:'gtm.js'});
+ var f=d.getElementsByTagName(s)[0],
+ j=d.createElement(s),
+ dl=l!='dataLayer'?'&l='+l:'';
+ j.async=true;
+ j.src='https://www.googletagmanager.com/gtm.js?id='+i+dl;
+ f.parentNode.insertBefore(j,f);
+ })(window,document,'script','dataLayer','GTM-5WLCZXC');
+</script>
+
+
+
+<body>
+<!-- Navigation -->
+<nav class="navbar navbar-inverse navbar-fixed-top">
+ <div class="container topnavlinks">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-ditto-home" href="index.html"> <img src="images/ditto_allwhite_symbolonly.svg" class="ditto-navbar-symbol" alt="Home"> <img src="images/ditto_allwhite_textonly.svg" class="ditto-navbar-symbol-text" alt="Ditto"></a>
+ </div>
+ <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
+ <ul class="nav navbar-nav navbar-right">
+ <!-- toggle sidebar button -->
+ <!--<li><a id="tg-sb-link" href="#"><i id="tg-sb-icon" class="fa fa-toggle-on"></i> Nav</a></li>-->
+ <!-- entries without drop-downs appear here -->
+
+
+
+
+
+
+
+ <li><a href="blog.html">Blog</a></li>
+
+
+
+ <li><a href="intro-overview.html">Documentation</a></li>
+
+
+
+ <li><a href="http-api-doc.html">HTTP API</a></li>
+
+
+
+ <li><a href="https://ditto.eclipse.org" target="_blank">Sandbox</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">GitHub</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">GitHub examples</a></li>
+
+
+
+ <!-- entries with drop-downs appear here -->
+ <!-- conditional logic to control which topnav appears for the audience defined in the configuration file.-->
+
+
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Links<b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+
+ <li><a href="https://projects.eclipse.org/projects/iot.ditto" target="_blank">Eclipse Ditto Project</a></li>
+
+
+
+ <li><a href="https://www.eclipse.org/forums/index.php/f/364/" target="_blank">Forum</a></li>
+
+
+
+ <li><a href="https://ci.eclipse.org/ditto/" target="_blank">Jenkins</a></li>
+
+
+
+ <li><a href="https://dev.eclipse.org/mhonarc/lists/ditto-dev/" target="_blank">Mailing list archives</a></li>
+
+
+
+ <li><a href="https://gitter.im/eclipse/ditto" target="_blank">Gitter.im chat</a></li>
+
+
+ </ul>
+ </li>
+
+
+
+ <!--comment out this block if you want to hide search-->
+ <li>
+ <!--start search-->
+ <div id="search-demo-container">
+ <input type="text" id="search-input" placeholder="search...">
+ <ul id="results-container"></ul>
+ </div>
+ <script src="//cdnjs.cloudflare.com/ajax/libs/simple-jekyll-search/0.0.9/jekyll-search.js" type="text/javascript"></script>
+ <script type="text/javascript">
+ SimpleJekyllSearch.init({
+ searchInput: document.getElementById('search-input'),
+ resultsContainer: document.getElementById('results-container'),
+ dataSource: 'search.json',
+ searchResultTemplate: '<li><a href="{url}" title="Retrieve a Policy">{title}</a></li>',
+ noResultsText: 'No results found.',
+ limit: 10,
+ fuzzy: true,
+ })
+ </script>
+ <!--end search-->
+ </li>
+ </ul>
+ </div>
+ </div>
+ <!-- /.container -->
+</nav>
+
+<!-- Page Content -->
+<div class="container">
+ <div id="main">
+ <!-- Content Row -->
+ <div class="row">
+
+
+ <!-- Sidebar Column -->
+ <div class="col-md-3" id="tg-sb-sidebar">
+
+
+<ul id="mysidebar" class="nav">
+ <li class="sidebarTitle">
+ <label for="docVersion">Eclipse Ditto version:</label>
+ <div class="select-wrapper">
+ <select id="docVersion" name="docVersion">
+
+ <option value="">development</option>
+
+ <option value="1.0">1.0</option>
+
+ <option value="1.1">1.1</option>
+
+ </select>
+ </div>
+ <div id="dev-warning">
+ <div markdown="span" class="alert alert-warning" role="alert" style="font-size:0.6em"><i class="fa fa-warning"></i> <b>Important:</b> This documentation reflects the latest 'development'. You might want to choose a released version.</div>
+ </div>
+ </li>
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Introduction</a>
+ <ul>
+
+
+
+ <li><a href="intro-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="intro-digitaltwins.html">Digital twins</a></li>
+
+
+
+
+
+
+ <li><a href="intro-hello-world.html">Hello world</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Release Notes</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_100.html">1.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_090.html">0.9.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_080.html">0.8.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Milestone releases</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_100-M2.html">1.0.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_100-M1a.html">1.0.0-M1a</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M2.html">0.9.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M1.html">0.9.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M3.html">0.8.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M2.html">0.8.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M1.html">0.8.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M2.html">0.3.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M1.html">0.3.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_020-M1.html">0.2.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M3.html">0.1.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M1.html">0.1.0-M1</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Installation</a>
+ <ul>
+
+
+
+ <li><a href="installation-building.html">Building Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-running.html">Running Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-operating.html">Operating Ditto</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Basic concepts</a>
+ <ul>
+
+
+
+ <li><a href="basic-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Model entities</a>
+ <ul>
+
+
+
+ <li><a href="basic-thing.html">Thing</a></li>
+
+
+
+
+
+ <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
+
+
+
+
+
+ <li><a href="basic-feature.html">Feature</a></li>
+
+
+
+
+
+ <li><a href="basic-policy.html">Policy</a></li>
+
+
+
+
+
+ <li><a href="basic-namespaces-and-names.html">Namespaces and Names</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-auth.html">Authentication and Authorization</a></li>
+
+
+
+
+
+
+ <li><a href="basic-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="basic-signals.html">Signals</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Signal types</a>
+ <ul>
+
+
+
+ <li><a href="basic-signals-command.html">Command</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-commandresponse.html">Command response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-errorresponse.html">Error response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-event.html">Event</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-apis.html">APIs</a></li>
+
+
+
+
+
+
+ <li><a href="basic-connections.html">Connections</a></li>
+
+
+
+
+
+
+ <li><a href="basic-placeholders.html">Placeholders</a></li>
+
+
+
+
+
+
+ <li><a href="basic-changenotifications.html">Change notifications</a></li>
+
+
+
+
+
+
+ <li><a href="basic-rql.html">RQL expressions</a></li>
+
+
+
+
+
+
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
+ <li><a href="basic-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Architecture</a>
+ <ul>
+
+
+
+ <li><a href="architecture-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Services</a>
+ <ul>
+
+
+
+ <li><a href="architecture-services-policies.html">Policies</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things.html">Things</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things-search.html">Things-Search</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-connectivity.html">Connectivity</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-concierge.html">Concierge</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-gateway.html">Gateway</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>HTTP API</a>
+ <ul>
+
+
+
+ <li><a href="httpapi-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-concepts.html">Concepts</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-protocol-bindings-websocket.html">WebSocket protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-sse.html">Server sent events</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Connectivity API</a>
+ <ul>
+
+
+
+ <li><a href="connectivity-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-manage-connections.html">Manage connections</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp091.html">AMQP 0.9.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp10.html">AMQP 1.0 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-kafka2.html">Kafka 2.x protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-mapping.html">Payload mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-header-mapping.html">Header mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-tls-certificates.html">TLS certificates</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Client SDK</a>
+ <ul>
+
+
+
+ <li><a href="client-sdk-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-java.html">Java</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-javascript.html">JavaScript</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Ditto Protocol</a>
+ <ul>
+
+
+
+ <li><a href="protocol-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-twinlive.html">Twin/live channel</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification.html">Specification</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-topic.html">Protocol topic</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-things.html">Things group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-delete.html">Delete</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ search/messages</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-search.html">Search</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-messages.html">Messages</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-bindings.html">Bindings</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-examples.html">Examples</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-creatething.html">Create a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletething.html">Delete a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifything.html">Modify a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievething.html">Retrieve a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethings.html">Retrieve multiple Things</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattributes.html">Delete Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattributes.html">Modify Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattributes.html">Retrieve Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattribute.html">Create a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattribute.html">Delete a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattribute.html">Modify a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattribute.html">Retrieve a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createthingdefinition.html">Create a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletethingdefinition.html">Delete a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifythingdefinition.html">Modify a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethingdefinition.html">Retrieve a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeatures.html">Create Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeatures.html">Delete Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeatures.html">Modify Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeatures.html">Retrieve Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeature.html">Create a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeature.html">Delete a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeature.html">Modify a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeature.html">Retrieve a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdefinition.html">Create Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedefinition.html">Delete Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydefinition.html">Modify Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedefinition.html">Retrieve Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperties.html">Create Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperties.html">Delete Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperties.html">Modify Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperties.html">Retrieve Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperty.html">Create a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperty.html">Delete a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperty.html">Modify a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperty.html">Retrieve a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li class="active"><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li><a href="sandbox.html">Sandbox</a></li>
+
+
+
+
+
+ <li><a href="presentations.html">Presentations</a></li>
+
+
+
+
+
+ <li><a href="glossary.html">Glossary</a></li>
+
+
+
+
+
+ <li><a href="feedback.html">Feedback</a></li>
+
+
+
+
+
+ <p class="external">
+ <a href="#" id="collapseAll">Collapse All</a> | <a href="#" id="expandAll">Expand All</a>
+ </p>
+
+</ul>
+
+<!-- this highlights the active parent class in the sidebar. this is critical so that the parent expands when you're viewing a page. This must appear below the sidebar code above. Otherwise, if placed inside customscripts.js, the script runs before the sidebar code runs and the class never gets inserted.-->
+<script>$("li.active").parents('li').toggleClass("active");
+
+$(function() {
+ $("#dev-warning").hide();
+ changeSelectedDocVersionDropdownSelection($("#docVersion")[0]);
+ $("#docVersion").change(changeSelectedDocVersion);
+});
+
+function changeSelectedDocVersionDropdownSelection(element) {
+ var pathName = window.location.pathname;
+
+ var versionOptions = element.options;
+ for (var i = 0; i < versionOptions.length; i++) {
+ var versionValue = versionOptions[i].value;
+ if ((versionValue !== "") && pathName.startsWith("/ditto/"+versionValue+"/")) {
+ $("#docVersion").val(versionValue).change();
+ return;
+ }
+ }
+ // fallback: dev with "empty" version value:
+ $("#docVersion").val("").change();
+ $("#dev-warning").show();
+}
+function changeSelectedDocVersion() {
+ var versionValue = $('#docVersion').val();
+ var remainingPath = window.location.pathname.replace("/ditto/", "");
+ var versionMatch = remainingPath.match("([0-9].[0.9])/(.*)");
+ if (versionValue === "" && !versionMatch) {
+ // do nothing, we're already on the correct "dev" version
+ } else if (versionMatch && (versionValue === versionMatch[1])) {
+ // do nothing, we're already on the correct version
+ } else {
+ if (versionValue === "" && versionMatch) {
+ window.location.pathname = "ditto/" + versionMatch[2];
+ } else if (versionValue === "") {
+ window.location.pathname = "ditto/" + remainingPath;
+ } else if (versionMatch) {
+ window.location.pathname = "ditto/" + versionValue + "/" + versionMatch[2];
+ } else {
+ window.location.pathname = "ditto/" + versionValue + "/" + remainingPath;
+ }
+ }
+}
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Retrieve a Policy</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+
+
+
+<!-- this handles the automatic toc. use ## for subheads to auto-generate the on-page minitoc. if you use html tags, you must supply an ID for the heading element in order for it to appear in the minitoc. -->
+<script>
+$( document ).ready(function() {
+ // Handler for .ready() called.
+
+$('#toc').toc({ minimumHeaders: 0, listType: 'ul', showSpeed: 0, headers: 'h2,h3,h4' });
+
+/* this offset helps account for the space taken up by the floating toolbar. */
+$('#toc').on('click', 'a', function() {
+ var target = $(this.getAttribute('href'))
+ , scroll_target = target.offset().top
+
+ $(window).scrollTop(scroll_target - 10);
+ return false
+})
+
+});
+</script>
+
+<div id="toc"></div>
+
+
+
+
+
+
+
+
+
+
+<h2 id="retrievepolicy">RetrievePolicy</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/the_policy_id/policies/commands/retrieve"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="retrievepolicyresponse">RetrievePolicyResponse</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/the_policy_id/policies/commands/retrieve"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"policyId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme:the_policy_id"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"entries"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"the_label"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"subjects"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"google:the_subjectid"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"yourSubjectTypeDescription"</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"resources"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"thing:/the_resource_path"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"grant"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
+ </span><span class="s2">"READ"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"WRITE"</span><span class="w">
+ </span><span class="p">],</span><span class="w">
+ </span><span class="s2">"revoke"</span><span class="p">:</span><span class="w"> </span><span class="p">[]</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">200</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+
+
+ <div class="tags">
+
+ </div>
+
+</div>
+
+<hr class="shaded"/>
+
+<footer>
+ <div class="row">
+ <div class="col-lg-12 footer">
+ <div class="logo">
+ <a href="https://eclipse.org"><img src="images/eclipse_foundation_logo.svg" alt="Eclipse logo"/></a>
+ </div>
+ <p class="notice">
+ ©2020 Eclipse Ditto.
+ Site last generated: Jul 1, 2020 <br />
+ </p>
+ <div class="quickLinks">
+ <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
+ > Privacy Policy
+ </a>
+ <a href="https://www.eclipse.org/legal/termsofuse.php" target="_blank">
+ > Terms of Use
+ </a>
+ <a href="https://www.eclipse.org/legal/copyright.php" target="_blank">
+ > Copyright Agent
+ </a>
+ <a href="https://www.eclipse.org/legal" target="_blank">
+ > Legal
+ </a>
+ <a href="https://www.eclipse.org/legal/epl-2.0/" target="_blank">
+ > License
+ </a>
+ <a href="https://eclipse.org/security" target="_blank">
+ > Report a Vulnerability
+ </a>
+ </div>
+ </div>
+ </div>
+</footer>
+
+
+ </div>
+ <!-- /.row -->
+</div>
+<!-- /.container -->
+</div>
+<!-- /#main -->
+ </div>
+
+</body>
+</html>
diff --git a/1.0/protocol-examples-policies-retrievepolicyentries.html b/1.0/protocol-examples-policies-retrievepolicyentries.html
new file mode 100644
index 0000000..7688732
--- /dev/null
+++ b/1.0/protocol-examples-policies-retrievepolicyentries.html
@@ -0,0 +1,1584 @@
+<!DOCTYPE html>
+<html>
+<head>
+ <meta charset="utf-8">
+<meta http-equiv="X-UA-Compatible" content="IE=edge">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="description" content="">
+<meta name="keywords" content=" examples, retrieve policy entries">
+<title> Retrieve Policy entries • Eclipse Ditto • a digital twin framework</title>
+
+<link rel="stylesheet" href="css/syntax.css">
+<link rel="stylesheet" type="text/css" href="//cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/modern-business.css">
+<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/customstyles.css">
+<link rel="stylesheet" href="css/boxshadowproperties.css">
+<link rel="stylesheet" href="css/theme-ditto.css">
+<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:400,700|Source+Code+Pro:300,600|Titillium+Web:400,600,700">
+
+<script src="//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.4/jquery.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/js/bootstrap.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/anchor-js/2.0.0/anchor.min.js" crossorigin="anonymous"></script>
+<script src="js/toc.js"></script>
+<script src="js/customscripts.js"></script>
+
+<script type="application/ld+json">
+{
+ "@context": "http://schema.org",
+ "@type": "Organization",
+ "url": "https://eclipse.org/ditto/",
+ "logo": "https://eclipse.org/ditto/images/ditto.svg"
+}
+</script>
+
+<link rel="icon" type="image/png" href="images/favicon-16x16.png" sizes="16x16">
+<link rel="icon" type="image/png" href="images/favicon-32x32.png" sizes="32x32">
+<link rel="icon" type="image/png" href="images/favicon-96x96.png" sizes="96x96">
+
+<link rel="alternate" type="application/rss+xml" title="Eclipse Ditto Blog" href="https://www.eclipse.org/ditto/feed.xml">
+
+<!-- Eclipse Foundation cookie consent: -->
+<link rel="stylesheet" type="text/css" href="//www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css" />
+<script src="//www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+ <script>
+ $(document).ready(function() {
+ $("#tg-sb-link").click(function() {
+ $("#tg-sb-sidebar").toggle();
+ $("#tg-sb-content").toggleClass('col-md-9');
+ $("#tg-sb-content").toggleClass('col-md-12');
+ $("#tg-sb-icon").toggleClass('fa-toggle-on');
+ $("#tg-sb-icon").toggleClass('fa-toggle-off');
+ });
+ });
+ </script>
+</head>
+
+
+<script>
+ (function(w,d,s,l,i){
+ w[l]=w[l]||[];
+ w[l].push({'gtm.start':
+ new Date().getTime(),event:'gtm.js'});
+ var f=d.getElementsByTagName(s)[0],
+ j=d.createElement(s),
+ dl=l!='dataLayer'?'&l='+l:'';
+ j.async=true;
+ j.src='https://www.googletagmanager.com/gtm.js?id='+i+dl;
+ f.parentNode.insertBefore(j,f);
+ })(window,document,'script','dataLayer','GTM-5WLCZXC');
+</script>
+
+
+
+<body>
+<!-- Navigation -->
+<nav class="navbar navbar-inverse navbar-fixed-top">
+ <div class="container topnavlinks">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-ditto-home" href="index.html"> <img src="images/ditto_allwhite_symbolonly.svg" class="ditto-navbar-symbol" alt="Home"> <img src="images/ditto_allwhite_textonly.svg" class="ditto-navbar-symbol-text" alt="Ditto"></a>
+ </div>
+ <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
+ <ul class="nav navbar-nav navbar-right">
+ <!-- toggle sidebar button -->
+ <!--<li><a id="tg-sb-link" href="#"><i id="tg-sb-icon" class="fa fa-toggle-on"></i> Nav</a></li>-->
+ <!-- entries without drop-downs appear here -->
+
+
+
+
+
+
+
+ <li><a href="blog.html">Blog</a></li>
+
+
+
+ <li><a href="intro-overview.html">Documentation</a></li>
+
+
+
+ <li><a href="http-api-doc.html">HTTP API</a></li>
+
+
+
+ <li><a href="https://ditto.eclipse.org" target="_blank">Sandbox</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">GitHub</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">GitHub examples</a></li>
+
+
+
+ <!-- entries with drop-downs appear here -->
+ <!-- conditional logic to control which topnav appears for the audience defined in the configuration file.-->
+
+
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Links<b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+
+ <li><a href="https://projects.eclipse.org/projects/iot.ditto" target="_blank">Eclipse Ditto Project</a></li>
+
+
+
+ <li><a href="https://www.eclipse.org/forums/index.php/f/364/" target="_blank">Forum</a></li>
+
+
+
+ <li><a href="https://ci.eclipse.org/ditto/" target="_blank">Jenkins</a></li>
+
+
+
+ <li><a href="https://dev.eclipse.org/mhonarc/lists/ditto-dev/" target="_blank">Mailing list archives</a></li>
+
+
+
+ <li><a href="https://gitter.im/eclipse/ditto" target="_blank">Gitter.im chat</a></li>
+
+
+ </ul>
+ </li>
+
+
+
+ <!--comment out this block if you want to hide search-->
+ <li>
+ <!--start search-->
+ <div id="search-demo-container">
+ <input type="text" id="search-input" placeholder="search...">
+ <ul id="results-container"></ul>
+ </div>
+ <script src="//cdnjs.cloudflare.com/ajax/libs/simple-jekyll-search/0.0.9/jekyll-search.js" type="text/javascript"></script>
+ <script type="text/javascript">
+ SimpleJekyllSearch.init({
+ searchInput: document.getElementById('search-input'),
+ resultsContainer: document.getElementById('results-container'),
+ dataSource: 'search.json',
+ searchResultTemplate: '<li><a href="{url}" title="Retrieve Policy entries">{title}</a></li>',
+ noResultsText: 'No results found.',
+ limit: 10,
+ fuzzy: true,
+ })
+ </script>
+ <!--end search-->
+ </li>
+ </ul>
+ </div>
+ </div>
+ <!-- /.container -->
+</nav>
+
+<!-- Page Content -->
+<div class="container">
+ <div id="main">
+ <!-- Content Row -->
+ <div class="row">
+
+
+ <!-- Sidebar Column -->
+ <div class="col-md-3" id="tg-sb-sidebar">
+
+
+<ul id="mysidebar" class="nav">
+ <li class="sidebarTitle">
+ <label for="docVersion">Eclipse Ditto version:</label>
+ <div class="select-wrapper">
+ <select id="docVersion" name="docVersion">
+
+ <option value="">development</option>
+
+ <option value="1.0">1.0</option>
+
+ <option value="1.1">1.1</option>
+
+ </select>
+ </div>
+ <div id="dev-warning">
+ <div markdown="span" class="alert alert-warning" role="alert" style="font-size:0.6em"><i class="fa fa-warning"></i> <b>Important:</b> This documentation reflects the latest 'development'. You might want to choose a released version.</div>
+ </div>
+ </li>
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Introduction</a>
+ <ul>
+
+
+
+ <li><a href="intro-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="intro-digitaltwins.html">Digital twins</a></li>
+
+
+
+
+
+
+ <li><a href="intro-hello-world.html">Hello world</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Release Notes</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_100.html">1.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_090.html">0.9.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_080.html">0.8.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Milestone releases</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_100-M2.html">1.0.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_100-M1a.html">1.0.0-M1a</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M2.html">0.9.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M1.html">0.9.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M3.html">0.8.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M2.html">0.8.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M1.html">0.8.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M2.html">0.3.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M1.html">0.3.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_020-M1.html">0.2.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M3.html">0.1.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M1.html">0.1.0-M1</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Installation</a>
+ <ul>
+
+
+
+ <li><a href="installation-building.html">Building Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-running.html">Running Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-operating.html">Operating Ditto</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Basic concepts</a>
+ <ul>
+
+
+
+ <li><a href="basic-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Model entities</a>
+ <ul>
+
+
+
+ <li><a href="basic-thing.html">Thing</a></li>
+
+
+
+
+
+ <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
+
+
+
+
+
+ <li><a href="basic-feature.html">Feature</a></li>
+
+
+
+
+
+ <li><a href="basic-policy.html">Policy</a></li>
+
+
+
+
+
+ <li><a href="basic-namespaces-and-names.html">Namespaces and Names</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-auth.html">Authentication and Authorization</a></li>
+
+
+
+
+
+
+ <li><a href="basic-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="basic-signals.html">Signals</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Signal types</a>
+ <ul>
+
+
+
+ <li><a href="basic-signals-command.html">Command</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-commandresponse.html">Command response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-errorresponse.html">Error response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-event.html">Event</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-apis.html">APIs</a></li>
+
+
+
+
+
+
+ <li><a href="basic-connections.html">Connections</a></li>
+
+
+
+
+
+
+ <li><a href="basic-placeholders.html">Placeholders</a></li>
+
+
+
+
+
+
+ <li><a href="basic-changenotifications.html">Change notifications</a></li>
+
+
+
+
+
+
+ <li><a href="basic-rql.html">RQL expressions</a></li>
+
+
+
+
+
+
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
+ <li><a href="basic-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Architecture</a>
+ <ul>
+
+
+
+ <li><a href="architecture-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Services</a>
+ <ul>
+
+
+
+ <li><a href="architecture-services-policies.html">Policies</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things.html">Things</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things-search.html">Things-Search</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-connectivity.html">Connectivity</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-concierge.html">Concierge</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-gateway.html">Gateway</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>HTTP API</a>
+ <ul>
+
+
+
+ <li><a href="httpapi-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-concepts.html">Concepts</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-protocol-bindings-websocket.html">WebSocket protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-sse.html">Server sent events</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Connectivity API</a>
+ <ul>
+
+
+
+ <li><a href="connectivity-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-manage-connections.html">Manage connections</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp091.html">AMQP 0.9.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp10.html">AMQP 1.0 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-kafka2.html">Kafka 2.x protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-mapping.html">Payload mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-header-mapping.html">Header mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-tls-certificates.html">TLS certificates</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Client SDK</a>
+ <ul>
+
+
+
+ <li><a href="client-sdk-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-java.html">Java</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-javascript.html">JavaScript</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Ditto Protocol</a>
+ <ul>
+
+
+
+ <li><a href="protocol-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-twinlive.html">Twin/live channel</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification.html">Specification</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-topic.html">Protocol topic</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-things.html">Things group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-delete.html">Delete</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ search/messages</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-search.html">Search</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-messages.html">Messages</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-bindings.html">Bindings</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-examples.html">Examples</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-creatething.html">Create a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletething.html">Delete a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifything.html">Modify a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievething.html">Retrieve a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethings.html">Retrieve multiple Things</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattributes.html">Delete Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattributes.html">Modify Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattributes.html">Retrieve Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattribute.html">Create a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattribute.html">Delete a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattribute.html">Modify a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattribute.html">Retrieve a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createthingdefinition.html">Create a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletethingdefinition.html">Delete a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifythingdefinition.html">Modify a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethingdefinition.html">Retrieve a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeatures.html">Create Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeatures.html">Delete Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeatures.html">Modify Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeatures.html">Retrieve Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeature.html">Create a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeature.html">Delete a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeature.html">Modify a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeature.html">Retrieve a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdefinition.html">Create Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedefinition.html">Delete Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydefinition.html">Modify Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedefinition.html">Retrieve Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperties.html">Create Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperties.html">Delete Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperties.html">Modify Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperties.html">Retrieve Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperty.html">Create a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperty.html">Delete a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperty.html">Modify a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperty.html">Retrieve a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li class="active"><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li><a href="sandbox.html">Sandbox</a></li>
+
+
+
+
+
+ <li><a href="presentations.html">Presentations</a></li>
+
+
+
+
+
+ <li><a href="glossary.html">Glossary</a></li>
+
+
+
+
+
+ <li><a href="feedback.html">Feedback</a></li>
+
+
+
+
+
+ <p class="external">
+ <a href="#" id="collapseAll">Collapse All</a> | <a href="#" id="expandAll">Expand All</a>
+ </p>
+
+</ul>
+
+<!-- this highlights the active parent class in the sidebar. this is critical so that the parent expands when you're viewing a page. This must appear below the sidebar code above. Otherwise, if placed inside customscripts.js, the script runs before the sidebar code runs and the class never gets inserted.-->
+<script>$("li.active").parents('li').toggleClass("active");
+
+$(function() {
+ $("#dev-warning").hide();
+ changeSelectedDocVersionDropdownSelection($("#docVersion")[0]);
+ $("#docVersion").change(changeSelectedDocVersion);
+});
+
+function changeSelectedDocVersionDropdownSelection(element) {
+ var pathName = window.location.pathname;
+
+ var versionOptions = element.options;
+ for (var i = 0; i < versionOptions.length; i++) {
+ var versionValue = versionOptions[i].value;
+ if ((versionValue !== "") && pathName.startsWith("/ditto/"+versionValue+"/")) {
+ $("#docVersion").val(versionValue).change();
+ return;
+ }
+ }
+ // fallback: dev with "empty" version value:
+ $("#docVersion").val("").change();
+ $("#dev-warning").show();
+}
+function changeSelectedDocVersion() {
+ var versionValue = $('#docVersion').val();
+ var remainingPath = window.location.pathname.replace("/ditto/", "");
+ var versionMatch = remainingPath.match("([0-9].[0.9])/(.*)");
+ if (versionValue === "" && !versionMatch) {
+ // do nothing, we're already on the correct "dev" version
+ } else if (versionMatch && (versionValue === versionMatch[1])) {
+ // do nothing, we're already on the correct version
+ } else {
+ if (versionValue === "" && versionMatch) {
+ window.location.pathname = "ditto/" + versionMatch[2];
+ } else if (versionValue === "") {
+ window.location.pathname = "ditto/" + remainingPath;
+ } else if (versionMatch) {
+ window.location.pathname = "ditto/" + versionValue + "/" + versionMatch[2];
+ } else {
+ window.location.pathname = "ditto/" + versionValue + "/" + remainingPath;
+ }
+ }
+}
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Retrieve Policy entries</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+
+
+
+<!-- this handles the automatic toc. use ## for subheads to auto-generate the on-page minitoc. if you use html tags, you must supply an ID for the heading element in order for it to appear in the minitoc. -->
+<script>
+$( document ).ready(function() {
+ // Handler for .ready() called.
+
+$('#toc').toc({ minimumHeaders: 0, listType: 'ul', showSpeed: 0, headers: 'h2,h3,h4' });
+
+/* this offset helps account for the space taken up by the floating toolbar. */
+$('#toc').on('click', 'a', function() {
+ var target = $(this.getAttribute('href'))
+ , scroll_target = target.offset().top
+
+ $(window).scrollTop(scroll_target - 10);
+ return false
+})
+
+});
+</script>
+
+<div id="toc"></div>
+
+
+
+
+
+
+
+
+
+
+<h2 id="retrievepolicyentries">RetrievePolicyEntries</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/the_policy_id/policies/commands/retrieve"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/entries"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="retrievepolicyentriesresponse">RetrievePolicyEntriesResponse</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/the_policy_id/policies/commands/retrieve"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/entries"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"another_label"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"subjects"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"google:the_subjectid"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"yourSubjectTypeDescription"</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"resources"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"thing:/the_resource_path"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"grant"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
+ </span><span class="s2">"READ"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"WRITE"</span><span class="w">
+ </span><span class="p">],</span><span class="w">
+ </span><span class="s2">"revoke"</span><span class="p">:</span><span class="w"> </span><span class="p">[]</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"the_label"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"subjects"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"google:the_subjectid"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"yourSubjectTypeDescription"</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"resources"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"thing:/the_resource_path"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"grant"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
+ </span><span class="s2">"READ"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"WRITE"</span><span class="w">
+ </span><span class="p">],</span><span class="w">
+ </span><span class="s2">"revoke"</span><span class="p">:</span><span class="w"> </span><span class="p">[]</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">200</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+
+
+ <div class="tags">
+
+ </div>
+
+</div>
+
+<hr class="shaded"/>
+
+<footer>
+ <div class="row">
+ <div class="col-lg-12 footer">
+ <div class="logo">
+ <a href="https://eclipse.org"><img src="images/eclipse_foundation_logo.svg" alt="Eclipse logo"/></a>
+ </div>
+ <p class="notice">
+ ©2020 Eclipse Ditto.
+ Site last generated: Jul 1, 2020 <br />
+ </p>
+ <div class="quickLinks">
+ <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
+ > Privacy Policy
+ </a>
+ <a href="https://www.eclipse.org/legal/termsofuse.php" target="_blank">
+ > Terms of Use
+ </a>
+ <a href="https://www.eclipse.org/legal/copyright.php" target="_blank">
+ > Copyright Agent
+ </a>
+ <a href="https://www.eclipse.org/legal" target="_blank">
+ > Legal
+ </a>
+ <a href="https://www.eclipse.org/legal/epl-2.0/" target="_blank">
+ > License
+ </a>
+ <a href="https://eclipse.org/security" target="_blank">
+ > Report a Vulnerability
+ </a>
+ </div>
+ </div>
+ </div>
+</footer>
+
+
+ </div>
+ <!-- /.row -->
+</div>
+<!-- /.container -->
+</div>
+<!-- /#main -->
+ </div>
+
+</body>
+</html>
diff --git a/1.0/protocol-examples-policies-retrievepolicyentry.html b/1.0/protocol-examples-policies-retrievepolicyentry.html
new file mode 100644
index 0000000..7c66646
--- /dev/null
+++ b/1.0/protocol-examples-policies-retrievepolicyentry.html
@@ -0,0 +1,1566 @@
+<!DOCTYPE html>
+<html>
+<head>
+ <meta charset="utf-8">
+<meta http-equiv="X-UA-Compatible" content="IE=edge">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="description" content="">
+<meta name="keywords" content=" examples, retrieve policy entry">
+<title> Retrieve a Policy entry • Eclipse Ditto • a digital twin framework</title>
+
+<link rel="stylesheet" href="css/syntax.css">
+<link rel="stylesheet" type="text/css" href="//cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/modern-business.css">
+<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/customstyles.css">
+<link rel="stylesheet" href="css/boxshadowproperties.css">
+<link rel="stylesheet" href="css/theme-ditto.css">
+<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:400,700|Source+Code+Pro:300,600|Titillium+Web:400,600,700">
+
+<script src="//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.4/jquery.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/js/bootstrap.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/anchor-js/2.0.0/anchor.min.js" crossorigin="anonymous"></script>
+<script src="js/toc.js"></script>
+<script src="js/customscripts.js"></script>
+
+<script type="application/ld+json">
+{
+ "@context": "http://schema.org",
+ "@type": "Organization",
+ "url": "https://eclipse.org/ditto/",
+ "logo": "https://eclipse.org/ditto/images/ditto.svg"
+}
+</script>
+
+<link rel="icon" type="image/png" href="images/favicon-16x16.png" sizes="16x16">
+<link rel="icon" type="image/png" href="images/favicon-32x32.png" sizes="32x32">
+<link rel="icon" type="image/png" href="images/favicon-96x96.png" sizes="96x96">
+
+<link rel="alternate" type="application/rss+xml" title="Eclipse Ditto Blog" href="https://www.eclipse.org/ditto/feed.xml">
+
+<!-- Eclipse Foundation cookie consent: -->
+<link rel="stylesheet" type="text/css" href="//www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css" />
+<script src="//www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+ <script>
+ $(document).ready(function() {
+ $("#tg-sb-link").click(function() {
+ $("#tg-sb-sidebar").toggle();
+ $("#tg-sb-content").toggleClass('col-md-9');
+ $("#tg-sb-content").toggleClass('col-md-12');
+ $("#tg-sb-icon").toggleClass('fa-toggle-on');
+ $("#tg-sb-icon").toggleClass('fa-toggle-off');
+ });
+ });
+ </script>
+</head>
+
+
+<script>
+ (function(w,d,s,l,i){
+ w[l]=w[l]||[];
+ w[l].push({'gtm.start':
+ new Date().getTime(),event:'gtm.js'});
+ var f=d.getElementsByTagName(s)[0],
+ j=d.createElement(s),
+ dl=l!='dataLayer'?'&l='+l:'';
+ j.async=true;
+ j.src='https://www.googletagmanager.com/gtm.js?id='+i+dl;
+ f.parentNode.insertBefore(j,f);
+ })(window,document,'script','dataLayer','GTM-5WLCZXC');
+</script>
+
+
+
+<body>
+<!-- Navigation -->
+<nav class="navbar navbar-inverse navbar-fixed-top">
+ <div class="container topnavlinks">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-ditto-home" href="index.html"> <img src="images/ditto_allwhite_symbolonly.svg" class="ditto-navbar-symbol" alt="Home"> <img src="images/ditto_allwhite_textonly.svg" class="ditto-navbar-symbol-text" alt="Ditto"></a>
+ </div>
+ <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
+ <ul class="nav navbar-nav navbar-right">
+ <!-- toggle sidebar button -->
+ <!--<li><a id="tg-sb-link" href="#"><i id="tg-sb-icon" class="fa fa-toggle-on"></i> Nav</a></li>-->
+ <!-- entries without drop-downs appear here -->
+
+
+
+
+
+
+
+ <li><a href="blog.html">Blog</a></li>
+
+
+
+ <li><a href="intro-overview.html">Documentation</a></li>
+
+
+
+ <li><a href="http-api-doc.html">HTTP API</a></li>
+
+
+
+ <li><a href="https://ditto.eclipse.org" target="_blank">Sandbox</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">GitHub</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">GitHub examples</a></li>
+
+
+
+ <!-- entries with drop-downs appear here -->
+ <!-- conditional logic to control which topnav appears for the audience defined in the configuration file.-->
+
+
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Links<b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+
+ <li><a href="https://projects.eclipse.org/projects/iot.ditto" target="_blank">Eclipse Ditto Project</a></li>
+
+
+
+ <li><a href="https://www.eclipse.org/forums/index.php/f/364/" target="_blank">Forum</a></li>
+
+
+
+ <li><a href="https://ci.eclipse.org/ditto/" target="_blank">Jenkins</a></li>
+
+
+
+ <li><a href="https://dev.eclipse.org/mhonarc/lists/ditto-dev/" target="_blank">Mailing list archives</a></li>
+
+
+
+ <li><a href="https://gitter.im/eclipse/ditto" target="_blank">Gitter.im chat</a></li>
+
+
+ </ul>
+ </li>
+
+
+
+ <!--comment out this block if you want to hide search-->
+ <li>
+ <!--start search-->
+ <div id="search-demo-container">
+ <input type="text" id="search-input" placeholder="search...">
+ <ul id="results-container"></ul>
+ </div>
+ <script src="//cdnjs.cloudflare.com/ajax/libs/simple-jekyll-search/0.0.9/jekyll-search.js" type="text/javascript"></script>
+ <script type="text/javascript">
+ SimpleJekyllSearch.init({
+ searchInput: document.getElementById('search-input'),
+ resultsContainer: document.getElementById('results-container'),
+ dataSource: 'search.json',
+ searchResultTemplate: '<li><a href="{url}" title="Retrieve a Policy entry">{title}</a></li>',
+ noResultsText: 'No results found.',
+ limit: 10,
+ fuzzy: true,
+ })
+ </script>
+ <!--end search-->
+ </li>
+ </ul>
+ </div>
+ </div>
+ <!-- /.container -->
+</nav>
+
+<!-- Page Content -->
+<div class="container">
+ <div id="main">
+ <!-- Content Row -->
+ <div class="row">
+
+
+ <!-- Sidebar Column -->
+ <div class="col-md-3" id="tg-sb-sidebar">
+
+
+<ul id="mysidebar" class="nav">
+ <li class="sidebarTitle">
+ <label for="docVersion">Eclipse Ditto version:</label>
+ <div class="select-wrapper">
+ <select id="docVersion" name="docVersion">
+
+ <option value="">development</option>
+
+ <option value="1.0">1.0</option>
+
+ <option value="1.1">1.1</option>
+
+ </select>
+ </div>
+ <div id="dev-warning">
+ <div markdown="span" class="alert alert-warning" role="alert" style="font-size:0.6em"><i class="fa fa-warning"></i> <b>Important:</b> This documentation reflects the latest 'development'. You might want to choose a released version.</div>
+ </div>
+ </li>
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Introduction</a>
+ <ul>
+
+
+
+ <li><a href="intro-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="intro-digitaltwins.html">Digital twins</a></li>
+
+
+
+
+
+
+ <li><a href="intro-hello-world.html">Hello world</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Release Notes</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_100.html">1.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_090.html">0.9.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_080.html">0.8.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Milestone releases</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_100-M2.html">1.0.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_100-M1a.html">1.0.0-M1a</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M2.html">0.9.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M1.html">0.9.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M3.html">0.8.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M2.html">0.8.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M1.html">0.8.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M2.html">0.3.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M1.html">0.3.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_020-M1.html">0.2.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M3.html">0.1.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M1.html">0.1.0-M1</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Installation</a>
+ <ul>
+
+
+
+ <li><a href="installation-building.html">Building Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-running.html">Running Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-operating.html">Operating Ditto</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Basic concepts</a>
+ <ul>
+
+
+
+ <li><a href="basic-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Model entities</a>
+ <ul>
+
+
+
+ <li><a href="basic-thing.html">Thing</a></li>
+
+
+
+
+
+ <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
+
+
+
+
+
+ <li><a href="basic-feature.html">Feature</a></li>
+
+
+
+
+
+ <li><a href="basic-policy.html">Policy</a></li>
+
+
+
+
+
+ <li><a href="basic-namespaces-and-names.html">Namespaces and Names</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-auth.html">Authentication and Authorization</a></li>
+
+
+
+
+
+
+ <li><a href="basic-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="basic-signals.html">Signals</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Signal types</a>
+ <ul>
+
+
+
+ <li><a href="basic-signals-command.html">Command</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-commandresponse.html">Command response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-errorresponse.html">Error response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-event.html">Event</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-apis.html">APIs</a></li>
+
+
+
+
+
+
+ <li><a href="basic-connections.html">Connections</a></li>
+
+
+
+
+
+
+ <li><a href="basic-placeholders.html">Placeholders</a></li>
+
+
+
+
+
+
+ <li><a href="basic-changenotifications.html">Change notifications</a></li>
+
+
+
+
+
+
+ <li><a href="basic-rql.html">RQL expressions</a></li>
+
+
+
+
+
+
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
+ <li><a href="basic-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Architecture</a>
+ <ul>
+
+
+
+ <li><a href="architecture-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Services</a>
+ <ul>
+
+
+
+ <li><a href="architecture-services-policies.html">Policies</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things.html">Things</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things-search.html">Things-Search</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-connectivity.html">Connectivity</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-concierge.html">Concierge</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-gateway.html">Gateway</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>HTTP API</a>
+ <ul>
+
+
+
+ <li><a href="httpapi-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-concepts.html">Concepts</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-protocol-bindings-websocket.html">WebSocket protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-sse.html">Server sent events</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Connectivity API</a>
+ <ul>
+
+
+
+ <li><a href="connectivity-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-manage-connections.html">Manage connections</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp091.html">AMQP 0.9.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp10.html">AMQP 1.0 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-kafka2.html">Kafka 2.x protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-mapping.html">Payload mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-header-mapping.html">Header mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-tls-certificates.html">TLS certificates</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Client SDK</a>
+ <ul>
+
+
+
+ <li><a href="client-sdk-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-java.html">Java</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-javascript.html">JavaScript</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Ditto Protocol</a>
+ <ul>
+
+
+
+ <li><a href="protocol-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-twinlive.html">Twin/live channel</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification.html">Specification</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-topic.html">Protocol topic</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-things.html">Things group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-delete.html">Delete</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ search/messages</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-search.html">Search</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-messages.html">Messages</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-bindings.html">Bindings</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-examples.html">Examples</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-creatething.html">Create a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletething.html">Delete a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifything.html">Modify a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievething.html">Retrieve a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethings.html">Retrieve multiple Things</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattributes.html">Delete Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattributes.html">Modify Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattributes.html">Retrieve Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattribute.html">Create a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattribute.html">Delete a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattribute.html">Modify a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattribute.html">Retrieve a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createthingdefinition.html">Create a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletethingdefinition.html">Delete a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifythingdefinition.html">Modify a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethingdefinition.html">Retrieve a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeatures.html">Create Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeatures.html">Delete Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeatures.html">Modify Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeatures.html">Retrieve Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeature.html">Create a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeature.html">Delete a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeature.html">Modify a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeature.html">Retrieve a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdefinition.html">Create Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedefinition.html">Delete Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydefinition.html">Modify Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedefinition.html">Retrieve Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperties.html">Create Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperties.html">Delete Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperties.html">Modify Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperties.html">Retrieve Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperty.html">Create a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperty.html">Delete a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperty.html">Modify a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperty.html">Retrieve a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li class="active"><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li><a href="sandbox.html">Sandbox</a></li>
+
+
+
+
+
+ <li><a href="presentations.html">Presentations</a></li>
+
+
+
+
+
+ <li><a href="glossary.html">Glossary</a></li>
+
+
+
+
+
+ <li><a href="feedback.html">Feedback</a></li>
+
+
+
+
+
+ <p class="external">
+ <a href="#" id="collapseAll">Collapse All</a> | <a href="#" id="expandAll">Expand All</a>
+ </p>
+
+</ul>
+
+<!-- this highlights the active parent class in the sidebar. this is critical so that the parent expands when you're viewing a page. This must appear below the sidebar code above. Otherwise, if placed inside customscripts.js, the script runs before the sidebar code runs and the class never gets inserted.-->
+<script>$("li.active").parents('li').toggleClass("active");
+
+$(function() {
+ $("#dev-warning").hide();
+ changeSelectedDocVersionDropdownSelection($("#docVersion")[0]);
+ $("#docVersion").change(changeSelectedDocVersion);
+});
+
+function changeSelectedDocVersionDropdownSelection(element) {
+ var pathName = window.location.pathname;
+
+ var versionOptions = element.options;
+ for (var i = 0; i < versionOptions.length; i++) {
+ var versionValue = versionOptions[i].value;
+ if ((versionValue !== "") && pathName.startsWith("/ditto/"+versionValue+"/")) {
+ $("#docVersion").val(versionValue).change();
+ return;
+ }
+ }
+ // fallback: dev with "empty" version value:
+ $("#docVersion").val("").change();
+ $("#dev-warning").show();
+}
+function changeSelectedDocVersion() {
+ var versionValue = $('#docVersion').val();
+ var remainingPath = window.location.pathname.replace("/ditto/", "");
+ var versionMatch = remainingPath.match("([0-9].[0.9])/(.*)");
+ if (versionValue === "" && !versionMatch) {
+ // do nothing, we're already on the correct "dev" version
+ } else if (versionMatch && (versionValue === versionMatch[1])) {
+ // do nothing, we're already on the correct version
+ } else {
+ if (versionValue === "" && versionMatch) {
+ window.location.pathname = "ditto/" + versionMatch[2];
+ } else if (versionValue === "") {
+ window.location.pathname = "ditto/" + remainingPath;
+ } else if (versionMatch) {
+ window.location.pathname = "ditto/" + versionValue + "/" + versionMatch[2];
+ } else {
+ window.location.pathname = "ditto/" + versionValue + "/" + remainingPath;
+ }
+ }
+}
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Retrieve a Policy entry</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+
+
+
+<!-- this handles the automatic toc. use ## for subheads to auto-generate the on-page minitoc. if you use html tags, you must supply an ID for the heading element in order for it to appear in the minitoc. -->
+<script>
+$( document ).ready(function() {
+ // Handler for .ready() called.
+
+$('#toc').toc({ minimumHeaders: 0, listType: 'ul', showSpeed: 0, headers: 'h2,h3,h4' });
+
+/* this offset helps account for the space taken up by the floating toolbar. */
+$('#toc').on('click', 'a', function() {
+ var target = $(this.getAttribute('href'))
+ , scroll_target = target.offset().top
+
+ $(window).scrollTop(scroll_target - 10);
+ return false
+})
+
+});
+</script>
+
+<div id="toc"></div>
+
+
+
+
+
+
+
+
+
+
+<h2 id="retrievepolicyentry">RetrievePolicyEntry</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/the_policy_id/policies/commands/retrieve"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/entries/the_label"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="retrievepolicyentryresponse">RetrievePolicyEntryResponse</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/the_policy_id/policies/commands/retrieve"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/entries/the_label"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"subjects"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"google:the_subjectid"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"yourSubjectTypeDescription"</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"resources"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"thing:/the_resource_path"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"grant"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
+ </span><span class="s2">"READ"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"WRITE"</span><span class="w">
+ </span><span class="p">],</span><span class="w">
+ </span><span class="s2">"revoke"</span><span class="p">:</span><span class="w"> </span><span class="p">[]</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">200</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+
+
+ <div class="tags">
+
+ </div>
+
+</div>
+
+<hr class="shaded"/>
+
+<footer>
+ <div class="row">
+ <div class="col-lg-12 footer">
+ <div class="logo">
+ <a href="https://eclipse.org"><img src="images/eclipse_foundation_logo.svg" alt="Eclipse logo"/></a>
+ </div>
+ <p class="notice">
+ ©2020 Eclipse Ditto.
+ Site last generated: Jul 1, 2020 <br />
+ </p>
+ <div class="quickLinks">
+ <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
+ > Privacy Policy
+ </a>
+ <a href="https://www.eclipse.org/legal/termsofuse.php" target="_blank">
+ > Terms of Use
+ </a>
+ <a href="https://www.eclipse.org/legal/copyright.php" target="_blank">
+ > Copyright Agent
+ </a>
+ <a href="https://www.eclipse.org/legal" target="_blank">
+ > Legal
+ </a>
+ <a href="https://www.eclipse.org/legal/epl-2.0/" target="_blank">
+ > License
+ </a>
+ <a href="https://eclipse.org/security" target="_blank">
+ > Report a Vulnerability
+ </a>
+ </div>
+ </div>
+ </div>
+</footer>
+
+
+ </div>
+ <!-- /.row -->
+</div>
+<!-- /.container -->
+</div>
+<!-- /#main -->
+ </div>
+
+</body>
+</html>
diff --git a/1.0/protocol-examples-policies-retrieveresource.html b/1.0/protocol-examples-policies-retrieveresource.html
new file mode 100644
index 0000000..6882e31
--- /dev/null
+++ b/1.0/protocol-examples-policies-retrieveresource.html
@@ -0,0 +1,1557 @@
+<!DOCTYPE html>
+<html>
+<head>
+ <meta charset="utf-8">
+<meta http-equiv="X-UA-Compatible" content="IE=edge">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="description" content="">
+<meta name="keywords" content=" examples, retrieve resource">
+<title> Retrieve a resource • Eclipse Ditto • a digital twin framework</title>
+
+<link rel="stylesheet" href="css/syntax.css">
+<link rel="stylesheet" type="text/css" href="//cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/modern-business.css">
+<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/customstyles.css">
+<link rel="stylesheet" href="css/boxshadowproperties.css">
+<link rel="stylesheet" href="css/theme-ditto.css">
+<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:400,700|Source+Code+Pro:300,600|Titillium+Web:400,600,700">
+
+<script src="//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.4/jquery.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/js/bootstrap.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/anchor-js/2.0.0/anchor.min.js" crossorigin="anonymous"></script>
+<script src="js/toc.js"></script>
+<script src="js/customscripts.js"></script>
+
+<script type="application/ld+json">
+{
+ "@context": "http://schema.org",
+ "@type": "Organization",
+ "url": "https://eclipse.org/ditto/",
+ "logo": "https://eclipse.org/ditto/images/ditto.svg"
+}
+</script>
+
+<link rel="icon" type="image/png" href="images/favicon-16x16.png" sizes="16x16">
+<link rel="icon" type="image/png" href="images/favicon-32x32.png" sizes="32x32">
+<link rel="icon" type="image/png" href="images/favicon-96x96.png" sizes="96x96">
+
+<link rel="alternate" type="application/rss+xml" title="Eclipse Ditto Blog" href="https://www.eclipse.org/ditto/feed.xml">
+
+<!-- Eclipse Foundation cookie consent: -->
+<link rel="stylesheet" type="text/css" href="//www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css" />
+<script src="//www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+ <script>
+ $(document).ready(function() {
+ $("#tg-sb-link").click(function() {
+ $("#tg-sb-sidebar").toggle();
+ $("#tg-sb-content").toggleClass('col-md-9');
+ $("#tg-sb-content").toggleClass('col-md-12');
+ $("#tg-sb-icon").toggleClass('fa-toggle-on');
+ $("#tg-sb-icon").toggleClass('fa-toggle-off');
+ });
+ });
+ </script>
+</head>
+
+
+<script>
+ (function(w,d,s,l,i){
+ w[l]=w[l]||[];
+ w[l].push({'gtm.start':
+ new Date().getTime(),event:'gtm.js'});
+ var f=d.getElementsByTagName(s)[0],
+ j=d.createElement(s),
+ dl=l!='dataLayer'?'&l='+l:'';
+ j.async=true;
+ j.src='https://www.googletagmanager.com/gtm.js?id='+i+dl;
+ f.parentNode.insertBefore(j,f);
+ })(window,document,'script','dataLayer','GTM-5WLCZXC');
+</script>
+
+
+
+<body>
+<!-- Navigation -->
+<nav class="navbar navbar-inverse navbar-fixed-top">
+ <div class="container topnavlinks">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-ditto-home" href="index.html"> <img src="images/ditto_allwhite_symbolonly.svg" class="ditto-navbar-symbol" alt="Home"> <img src="images/ditto_allwhite_textonly.svg" class="ditto-navbar-symbol-text" alt="Ditto"></a>
+ </div>
+ <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
+ <ul class="nav navbar-nav navbar-right">
+ <!-- toggle sidebar button -->
+ <!--<li><a id="tg-sb-link" href="#"><i id="tg-sb-icon" class="fa fa-toggle-on"></i> Nav</a></li>-->
+ <!-- entries without drop-downs appear here -->
+
+
+
+
+
+
+
+ <li><a href="blog.html">Blog</a></li>
+
+
+
+ <li><a href="intro-overview.html">Documentation</a></li>
+
+
+
+ <li><a href="http-api-doc.html">HTTP API</a></li>
+
+
+
+ <li><a href="https://ditto.eclipse.org" target="_blank">Sandbox</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">GitHub</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">GitHub examples</a></li>
+
+
+
+ <!-- entries with drop-downs appear here -->
+ <!-- conditional logic to control which topnav appears for the audience defined in the configuration file.-->
+
+
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Links<b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+
+ <li><a href="https://projects.eclipse.org/projects/iot.ditto" target="_blank">Eclipse Ditto Project</a></li>
+
+
+
+ <li><a href="https://www.eclipse.org/forums/index.php/f/364/" target="_blank">Forum</a></li>
+
+
+
+ <li><a href="https://ci.eclipse.org/ditto/" target="_blank">Jenkins</a></li>
+
+
+
+ <li><a href="https://dev.eclipse.org/mhonarc/lists/ditto-dev/" target="_blank">Mailing list archives</a></li>
+
+
+
+ <li><a href="https://gitter.im/eclipse/ditto" target="_blank">Gitter.im chat</a></li>
+
+
+ </ul>
+ </li>
+
+
+
+ <!--comment out this block if you want to hide search-->
+ <li>
+ <!--start search-->
+ <div id="search-demo-container">
+ <input type="text" id="search-input" placeholder="search...">
+ <ul id="results-container"></ul>
+ </div>
+ <script src="//cdnjs.cloudflare.com/ajax/libs/simple-jekyll-search/0.0.9/jekyll-search.js" type="text/javascript"></script>
+ <script type="text/javascript">
+ SimpleJekyllSearch.init({
+ searchInput: document.getElementById('search-input'),
+ resultsContainer: document.getElementById('results-container'),
+ dataSource: 'search.json',
+ searchResultTemplate: '<li><a href="{url}" title="Retrieve a resource">{title}</a></li>',
+ noResultsText: 'No results found.',
+ limit: 10,
+ fuzzy: true,
+ })
+ </script>
+ <!--end search-->
+ </li>
+ </ul>
+ </div>
+ </div>
+ <!-- /.container -->
+</nav>
+
+<!-- Page Content -->
+<div class="container">
+ <div id="main">
+ <!-- Content Row -->
+ <div class="row">
+
+
+ <!-- Sidebar Column -->
+ <div class="col-md-3" id="tg-sb-sidebar">
+
+
+<ul id="mysidebar" class="nav">
+ <li class="sidebarTitle">
+ <label for="docVersion">Eclipse Ditto version:</label>
+ <div class="select-wrapper">
+ <select id="docVersion" name="docVersion">
+
+ <option value="">development</option>
+
+ <option value="1.0">1.0</option>
+
+ <option value="1.1">1.1</option>
+
+ </select>
+ </div>
+ <div id="dev-warning">
+ <div markdown="span" class="alert alert-warning" role="alert" style="font-size:0.6em"><i class="fa fa-warning"></i> <b>Important:</b> This documentation reflects the latest 'development'. You might want to choose a released version.</div>
+ </div>
+ </li>
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Introduction</a>
+ <ul>
+
+
+
+ <li><a href="intro-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="intro-digitaltwins.html">Digital twins</a></li>
+
+
+
+
+
+
+ <li><a href="intro-hello-world.html">Hello world</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Release Notes</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_100.html">1.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_090.html">0.9.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_080.html">0.8.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Milestone releases</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_100-M2.html">1.0.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_100-M1a.html">1.0.0-M1a</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M2.html">0.9.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M1.html">0.9.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M3.html">0.8.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M2.html">0.8.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M1.html">0.8.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M2.html">0.3.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M1.html">0.3.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_020-M1.html">0.2.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M3.html">0.1.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M1.html">0.1.0-M1</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Installation</a>
+ <ul>
+
+
+
+ <li><a href="installation-building.html">Building Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-running.html">Running Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-operating.html">Operating Ditto</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Basic concepts</a>
+ <ul>
+
+
+
+ <li><a href="basic-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Model entities</a>
+ <ul>
+
+
+
+ <li><a href="basic-thing.html">Thing</a></li>
+
+
+
+
+
+ <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
+
+
+
+
+
+ <li><a href="basic-feature.html">Feature</a></li>
+
+
+
+
+
+ <li><a href="basic-policy.html">Policy</a></li>
+
+
+
+
+
+ <li><a href="basic-namespaces-and-names.html">Namespaces and Names</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-auth.html">Authentication and Authorization</a></li>
+
+
+
+
+
+
+ <li><a href="basic-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="basic-signals.html">Signals</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Signal types</a>
+ <ul>
+
+
+
+ <li><a href="basic-signals-command.html">Command</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-commandresponse.html">Command response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-errorresponse.html">Error response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-event.html">Event</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-apis.html">APIs</a></li>
+
+
+
+
+
+
+ <li><a href="basic-connections.html">Connections</a></li>
+
+
+
+
+
+
+ <li><a href="basic-placeholders.html">Placeholders</a></li>
+
+
+
+
+
+
+ <li><a href="basic-changenotifications.html">Change notifications</a></li>
+
+
+
+
+
+
+ <li><a href="basic-rql.html">RQL expressions</a></li>
+
+
+
+
+
+
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
+ <li><a href="basic-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Architecture</a>
+ <ul>
+
+
+
+ <li><a href="architecture-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Services</a>
+ <ul>
+
+
+
+ <li><a href="architecture-services-policies.html">Policies</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things.html">Things</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things-search.html">Things-Search</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-connectivity.html">Connectivity</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-concierge.html">Concierge</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-gateway.html">Gateway</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>HTTP API</a>
+ <ul>
+
+
+
+ <li><a href="httpapi-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-concepts.html">Concepts</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-protocol-bindings-websocket.html">WebSocket protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-sse.html">Server sent events</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Connectivity API</a>
+ <ul>
+
+
+
+ <li><a href="connectivity-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-manage-connections.html">Manage connections</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp091.html">AMQP 0.9.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp10.html">AMQP 1.0 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-kafka2.html">Kafka 2.x protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-mapping.html">Payload mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-header-mapping.html">Header mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-tls-certificates.html">TLS certificates</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Client SDK</a>
+ <ul>
+
+
+
+ <li><a href="client-sdk-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-java.html">Java</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-javascript.html">JavaScript</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Ditto Protocol</a>
+ <ul>
+
+
+
+ <li><a href="protocol-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-twinlive.html">Twin/live channel</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification.html">Specification</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-topic.html">Protocol topic</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-things.html">Things group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-delete.html">Delete</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ search/messages</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-search.html">Search</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-messages.html">Messages</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-bindings.html">Bindings</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-examples.html">Examples</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-creatething.html">Create a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletething.html">Delete a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifything.html">Modify a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievething.html">Retrieve a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethings.html">Retrieve multiple Things</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattributes.html">Delete Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattributes.html">Modify Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattributes.html">Retrieve Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattribute.html">Create a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattribute.html">Delete a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattribute.html">Modify a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattribute.html">Retrieve a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createthingdefinition.html">Create a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletethingdefinition.html">Delete a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifythingdefinition.html">Modify a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethingdefinition.html">Retrieve a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeatures.html">Create Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeatures.html">Delete Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeatures.html">Modify Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeatures.html">Retrieve Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeature.html">Create a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeature.html">Delete a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeature.html">Modify a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeature.html">Retrieve a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdefinition.html">Create Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedefinition.html">Delete Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydefinition.html">Modify Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedefinition.html">Retrieve Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperties.html">Create Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperties.html">Delete Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperties.html">Modify Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperties.html">Retrieve Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperty.html">Create a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperty.html">Delete a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperty.html">Modify a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperty.html">Retrieve a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li class="active"><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li><a href="sandbox.html">Sandbox</a></li>
+
+
+
+
+
+ <li><a href="presentations.html">Presentations</a></li>
+
+
+
+
+
+ <li><a href="glossary.html">Glossary</a></li>
+
+
+
+
+
+ <li><a href="feedback.html">Feedback</a></li>
+
+
+
+
+
+ <p class="external">
+ <a href="#" id="collapseAll">Collapse All</a> | <a href="#" id="expandAll">Expand All</a>
+ </p>
+
+</ul>
+
+<!-- this highlights the active parent class in the sidebar. this is critical so that the parent expands when you're viewing a page. This must appear below the sidebar code above. Otherwise, if placed inside customscripts.js, the script runs before the sidebar code runs and the class never gets inserted.-->
+<script>$("li.active").parents('li').toggleClass("active");
+
+$(function() {
+ $("#dev-warning").hide();
+ changeSelectedDocVersionDropdownSelection($("#docVersion")[0]);
+ $("#docVersion").change(changeSelectedDocVersion);
+});
+
+function changeSelectedDocVersionDropdownSelection(element) {
+ var pathName = window.location.pathname;
+
+ var versionOptions = element.options;
+ for (var i = 0; i < versionOptions.length; i++) {
+ var versionValue = versionOptions[i].value;
+ if ((versionValue !== "") && pathName.startsWith("/ditto/"+versionValue+"/")) {
+ $("#docVersion").val(versionValue).change();
+ return;
+ }
+ }
+ // fallback: dev with "empty" version value:
+ $("#docVersion").val("").change();
+ $("#dev-warning").show();
+}
+function changeSelectedDocVersion() {
+ var versionValue = $('#docVersion').val();
+ var remainingPath = window.location.pathname.replace("/ditto/", "");
+ var versionMatch = remainingPath.match("([0-9].[0.9])/(.*)");
+ if (versionValue === "" && !versionMatch) {
+ // do nothing, we're already on the correct "dev" version
+ } else if (versionMatch && (versionValue === versionMatch[1])) {
+ // do nothing, we're already on the correct version
+ } else {
+ if (versionValue === "" && versionMatch) {
+ window.location.pathname = "ditto/" + versionMatch[2];
+ } else if (versionValue === "") {
+ window.location.pathname = "ditto/" + remainingPath;
+ } else if (versionMatch) {
+ window.location.pathname = "ditto/" + versionValue + "/" + versionMatch[2];
+ } else {
+ window.location.pathname = "ditto/" + versionValue + "/" + remainingPath;
+ }
+ }
+}
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Retrieve a resource</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+
+
+
+<!-- this handles the automatic toc. use ## for subheads to auto-generate the on-page minitoc. if you use html tags, you must supply an ID for the heading element in order for it to appear in the minitoc. -->
+<script>
+$( document ).ready(function() {
+ // Handler for .ready() called.
+
+$('#toc').toc({ minimumHeaders: 0, listType: 'ul', showSpeed: 0, headers: 'h2,h3,h4' });
+
+/* this offset helps account for the space taken up by the floating toolbar. */
+$('#toc').on('click', 'a', function() {
+ var target = $(this.getAttribute('href'))
+ , scroll_target = target.offset().top
+
+ $(window).scrollTop(scroll_target - 10);
+ return false
+})
+
+});
+</script>
+
+<div id="toc"></div>
+
+
+
+
+
+
+
+
+
+
+<h2 id="retrieveresource">RetrieveResource</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/the_policy_id/policies/commands/retrieve"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/entries/the_label/resources/thing:/the_resource_path"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="retrieveresourceresponse">RetrieveResourceResponse</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/the_policy_id/policies/commands/retrieve"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/entries/the_label/resources/thing:/the_resource_path"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"grant"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
+ </span><span class="s2">"READ"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"WRITE"</span><span class="w">
+ </span><span class="p">],</span><span class="w">
+ </span><span class="s2">"revoke"</span><span class="p">:</span><span class="w"> </span><span class="p">[]</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">200</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+
+
+ <div class="tags">
+
+ </div>
+
+</div>
+
+<hr class="shaded"/>
+
+<footer>
+ <div class="row">
+ <div class="col-lg-12 footer">
+ <div class="logo">
+ <a href="https://eclipse.org"><img src="images/eclipse_foundation_logo.svg" alt="Eclipse logo"/></a>
+ </div>
+ <p class="notice">
+ ©2020 Eclipse Ditto.
+ Site last generated: Jul 1, 2020 <br />
+ </p>
+ <div class="quickLinks">
+ <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
+ > Privacy Policy
+ </a>
+ <a href="https://www.eclipse.org/legal/termsofuse.php" target="_blank">
+ > Terms of Use
+ </a>
+ <a href="https://www.eclipse.org/legal/copyright.php" target="_blank">
+ > Copyright Agent
+ </a>
+ <a href="https://www.eclipse.org/legal" target="_blank">
+ > Legal
+ </a>
+ <a href="https://www.eclipse.org/legal/epl-2.0/" target="_blank">
+ > License
+ </a>
+ <a href="https://eclipse.org/security" target="_blank">
+ > Report a Vulnerability
+ </a>
+ </div>
+ </div>
+ </div>
+</footer>
+
+
+ </div>
+ <!-- /.row -->
+</div>
+<!-- /.container -->
+</div>
+<!-- /#main -->
+ </div>
+
+</body>
+</html>
diff --git a/1.0/protocol-examples-policies-retrieveresources.html b/1.0/protocol-examples-policies-retrieveresources.html
new file mode 100644
index 0000000..7021a09
--- /dev/null
+++ b/1.0/protocol-examples-policies-retrieveresources.html
@@ -0,0 +1,1559 @@
+<!DOCTYPE html>
+<html>
+<head>
+ <meta charset="utf-8">
+<meta http-equiv="X-UA-Compatible" content="IE=edge">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="description" content="">
+<meta name="keywords" content=" examples, retrieve resources">
+<title> Retrieve resources • Eclipse Ditto • a digital twin framework</title>
+
+<link rel="stylesheet" href="css/syntax.css">
+<link rel="stylesheet" type="text/css" href="//cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/modern-business.css">
+<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/customstyles.css">
+<link rel="stylesheet" href="css/boxshadowproperties.css">
+<link rel="stylesheet" href="css/theme-ditto.css">
+<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:400,700|Source+Code+Pro:300,600|Titillium+Web:400,600,700">
+
+<script src="//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.4/jquery.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/js/bootstrap.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/anchor-js/2.0.0/anchor.min.js" crossorigin="anonymous"></script>
+<script src="js/toc.js"></script>
+<script src="js/customscripts.js"></script>
+
+<script type="application/ld+json">
+{
+ "@context": "http://schema.org",
+ "@type": "Organization",
+ "url": "https://eclipse.org/ditto/",
+ "logo": "https://eclipse.org/ditto/images/ditto.svg"
+}
+</script>
+
+<link rel="icon" type="image/png" href="images/favicon-16x16.png" sizes="16x16">
+<link rel="icon" type="image/png" href="images/favicon-32x32.png" sizes="32x32">
+<link rel="icon" type="image/png" href="images/favicon-96x96.png" sizes="96x96">
+
+<link rel="alternate" type="application/rss+xml" title="Eclipse Ditto Blog" href="https://www.eclipse.org/ditto/feed.xml">
+
+<!-- Eclipse Foundation cookie consent: -->
+<link rel="stylesheet" type="text/css" href="//www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css" />
+<script src="//www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+ <script>
+ $(document).ready(function() {
+ $("#tg-sb-link").click(function() {
+ $("#tg-sb-sidebar").toggle();
+ $("#tg-sb-content").toggleClass('col-md-9');
+ $("#tg-sb-content").toggleClass('col-md-12');
+ $("#tg-sb-icon").toggleClass('fa-toggle-on');
+ $("#tg-sb-icon").toggleClass('fa-toggle-off');
+ });
+ });
+ </script>
+</head>
+
+
+<script>
+ (function(w,d,s,l,i){
+ w[l]=w[l]||[];
+ w[l].push({'gtm.start':
+ new Date().getTime(),event:'gtm.js'});
+ var f=d.getElementsByTagName(s)[0],
+ j=d.createElement(s),
+ dl=l!='dataLayer'?'&l='+l:'';
+ j.async=true;
+ j.src='https://www.googletagmanager.com/gtm.js?id='+i+dl;
+ f.parentNode.insertBefore(j,f);
+ })(window,document,'script','dataLayer','GTM-5WLCZXC');
+</script>
+
+
+
+<body>
+<!-- Navigation -->
+<nav class="navbar navbar-inverse navbar-fixed-top">
+ <div class="container topnavlinks">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-ditto-home" href="index.html"> <img src="images/ditto_allwhite_symbolonly.svg" class="ditto-navbar-symbol" alt="Home"> <img src="images/ditto_allwhite_textonly.svg" class="ditto-navbar-symbol-text" alt="Ditto"></a>
+ </div>
+ <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
+ <ul class="nav navbar-nav navbar-right">
+ <!-- toggle sidebar button -->
+ <!--<li><a id="tg-sb-link" href="#"><i id="tg-sb-icon" class="fa fa-toggle-on"></i> Nav</a></li>-->
+ <!-- entries without drop-downs appear here -->
+
+
+
+
+
+
+
+ <li><a href="blog.html">Blog</a></li>
+
+
+
+ <li><a href="intro-overview.html">Documentation</a></li>
+
+
+
+ <li><a href="http-api-doc.html">HTTP API</a></li>
+
+
+
+ <li><a href="https://ditto.eclipse.org" target="_blank">Sandbox</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">GitHub</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">GitHub examples</a></li>
+
+
+
+ <!-- entries with drop-downs appear here -->
+ <!-- conditional logic to control which topnav appears for the audience defined in the configuration file.-->
+
+
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Links<b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+
+ <li><a href="https://projects.eclipse.org/projects/iot.ditto" target="_blank">Eclipse Ditto Project</a></li>
+
+
+
+ <li><a href="https://www.eclipse.org/forums/index.php/f/364/" target="_blank">Forum</a></li>
+
+
+
+ <li><a href="https://ci.eclipse.org/ditto/" target="_blank">Jenkins</a></li>
+
+
+
+ <li><a href="https://dev.eclipse.org/mhonarc/lists/ditto-dev/" target="_blank">Mailing list archives</a></li>
+
+
+
+ <li><a href="https://gitter.im/eclipse/ditto" target="_blank">Gitter.im chat</a></li>
+
+
+ </ul>
+ </li>
+
+
+
+ <!--comment out this block if you want to hide search-->
+ <li>
+ <!--start search-->
+ <div id="search-demo-container">
+ <input type="text" id="search-input" placeholder="search...">
+ <ul id="results-container"></ul>
+ </div>
+ <script src="//cdnjs.cloudflare.com/ajax/libs/simple-jekyll-search/0.0.9/jekyll-search.js" type="text/javascript"></script>
+ <script type="text/javascript">
+ SimpleJekyllSearch.init({
+ searchInput: document.getElementById('search-input'),
+ resultsContainer: document.getElementById('results-container'),
+ dataSource: 'search.json',
+ searchResultTemplate: '<li><a href="{url}" title="Retrieve resources">{title}</a></li>',
+ noResultsText: 'No results found.',
+ limit: 10,
+ fuzzy: true,
+ })
+ </script>
+ <!--end search-->
+ </li>
+ </ul>
+ </div>
+ </div>
+ <!-- /.container -->
+</nav>
+
+<!-- Page Content -->
+<div class="container">
+ <div id="main">
+ <!-- Content Row -->
+ <div class="row">
+
+
+ <!-- Sidebar Column -->
+ <div class="col-md-3" id="tg-sb-sidebar">
+
+
+<ul id="mysidebar" class="nav">
+ <li class="sidebarTitle">
+ <label for="docVersion">Eclipse Ditto version:</label>
+ <div class="select-wrapper">
+ <select id="docVersion" name="docVersion">
+
+ <option value="">development</option>
+
+ <option value="1.0">1.0</option>
+
+ <option value="1.1">1.1</option>
+
+ </select>
+ </div>
+ <div id="dev-warning">
+ <div markdown="span" class="alert alert-warning" role="alert" style="font-size:0.6em"><i class="fa fa-warning"></i> <b>Important:</b> This documentation reflects the latest 'development'. You might want to choose a released version.</div>
+ </div>
+ </li>
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Introduction</a>
+ <ul>
+
+
+
+ <li><a href="intro-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="intro-digitaltwins.html">Digital twins</a></li>
+
+
+
+
+
+
+ <li><a href="intro-hello-world.html">Hello world</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Release Notes</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_100.html">1.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_090.html">0.9.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_080.html">0.8.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Milestone releases</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_100-M2.html">1.0.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_100-M1a.html">1.0.0-M1a</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M2.html">0.9.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M1.html">0.9.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M3.html">0.8.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M2.html">0.8.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M1.html">0.8.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M2.html">0.3.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M1.html">0.3.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_020-M1.html">0.2.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M3.html">0.1.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M1.html">0.1.0-M1</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Installation</a>
+ <ul>
+
+
+
+ <li><a href="installation-building.html">Building Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-running.html">Running Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-operating.html">Operating Ditto</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Basic concepts</a>
+ <ul>
+
+
+
+ <li><a href="basic-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Model entities</a>
+ <ul>
+
+
+
+ <li><a href="basic-thing.html">Thing</a></li>
+
+
+
+
+
+ <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
+
+
+
+
+
+ <li><a href="basic-feature.html">Feature</a></li>
+
+
+
+
+
+ <li><a href="basic-policy.html">Policy</a></li>
+
+
+
+
+
+ <li><a href="basic-namespaces-and-names.html">Namespaces and Names</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-auth.html">Authentication and Authorization</a></li>
+
+
+
+
+
+
+ <li><a href="basic-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="basic-signals.html">Signals</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Signal types</a>
+ <ul>
+
+
+
+ <li><a href="basic-signals-command.html">Command</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-commandresponse.html">Command response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-errorresponse.html">Error response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-event.html">Event</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-apis.html">APIs</a></li>
+
+
+
+
+
+
+ <li><a href="basic-connections.html">Connections</a></li>
+
+
+
+
+
+
+ <li><a href="basic-placeholders.html">Placeholders</a></li>
+
+
+
+
+
+
+ <li><a href="basic-changenotifications.html">Change notifications</a></li>
+
+
+
+
+
+
+ <li><a href="basic-rql.html">RQL expressions</a></li>
+
+
+
+
+
+
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
+ <li><a href="basic-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Architecture</a>
+ <ul>
+
+
+
+ <li><a href="architecture-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Services</a>
+ <ul>
+
+
+
+ <li><a href="architecture-services-policies.html">Policies</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things.html">Things</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things-search.html">Things-Search</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-connectivity.html">Connectivity</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-concierge.html">Concierge</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-gateway.html">Gateway</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>HTTP API</a>
+ <ul>
+
+
+
+ <li><a href="httpapi-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-concepts.html">Concepts</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-protocol-bindings-websocket.html">WebSocket protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-sse.html">Server sent events</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Connectivity API</a>
+ <ul>
+
+
+
+ <li><a href="connectivity-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-manage-connections.html">Manage connections</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp091.html">AMQP 0.9.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp10.html">AMQP 1.0 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-kafka2.html">Kafka 2.x protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-mapping.html">Payload mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-header-mapping.html">Header mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-tls-certificates.html">TLS certificates</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Client SDK</a>
+ <ul>
+
+
+
+ <li><a href="client-sdk-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-java.html">Java</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-javascript.html">JavaScript</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Ditto Protocol</a>
+ <ul>
+
+
+
+ <li><a href="protocol-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-twinlive.html">Twin/live channel</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification.html">Specification</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-topic.html">Protocol topic</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-things.html">Things group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-delete.html">Delete</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ search/messages</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-search.html">Search</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-messages.html">Messages</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-bindings.html">Bindings</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-examples.html">Examples</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-creatething.html">Create a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletething.html">Delete a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifything.html">Modify a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievething.html">Retrieve a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethings.html">Retrieve multiple Things</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattributes.html">Delete Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattributes.html">Modify Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattributes.html">Retrieve Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattribute.html">Create a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattribute.html">Delete a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattribute.html">Modify a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattribute.html">Retrieve a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createthingdefinition.html">Create a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletethingdefinition.html">Delete a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifythingdefinition.html">Modify a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethingdefinition.html">Retrieve a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeatures.html">Create Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeatures.html">Delete Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeatures.html">Modify Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeatures.html">Retrieve Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeature.html">Create a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeature.html">Delete a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeature.html">Modify a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeature.html">Retrieve a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdefinition.html">Create Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedefinition.html">Delete Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydefinition.html">Modify Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedefinition.html">Retrieve Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperties.html">Create Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperties.html">Delete Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperties.html">Modify Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperties.html">Retrieve Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperty.html">Create a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperty.html">Delete a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperty.html">Modify a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperty.html">Retrieve a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li class="active"><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li><a href="sandbox.html">Sandbox</a></li>
+
+
+
+
+
+ <li><a href="presentations.html">Presentations</a></li>
+
+
+
+
+
+ <li><a href="glossary.html">Glossary</a></li>
+
+
+
+
+
+ <li><a href="feedback.html">Feedback</a></li>
+
+
+
+
+
+ <p class="external">
+ <a href="#" id="collapseAll">Collapse All</a> | <a href="#" id="expandAll">Expand All</a>
+ </p>
+
+</ul>
+
+<!-- this highlights the active parent class in the sidebar. this is critical so that the parent expands when you're viewing a page. This must appear below the sidebar code above. Otherwise, if placed inside customscripts.js, the script runs before the sidebar code runs and the class never gets inserted.-->
+<script>$("li.active").parents('li').toggleClass("active");
+
+$(function() {
+ $("#dev-warning").hide();
+ changeSelectedDocVersionDropdownSelection($("#docVersion")[0]);
+ $("#docVersion").change(changeSelectedDocVersion);
+});
+
+function changeSelectedDocVersionDropdownSelection(element) {
+ var pathName = window.location.pathname;
+
+ var versionOptions = element.options;
+ for (var i = 0; i < versionOptions.length; i++) {
+ var versionValue = versionOptions[i].value;
+ if ((versionValue !== "") && pathName.startsWith("/ditto/"+versionValue+"/")) {
+ $("#docVersion").val(versionValue).change();
+ return;
+ }
+ }
+ // fallback: dev with "empty" version value:
+ $("#docVersion").val("").change();
+ $("#dev-warning").show();
+}
+function changeSelectedDocVersion() {
+ var versionValue = $('#docVersion').val();
+ var remainingPath = window.location.pathname.replace("/ditto/", "");
+ var versionMatch = remainingPath.match("([0-9].[0.9])/(.*)");
+ if (versionValue === "" && !versionMatch) {
+ // do nothing, we're already on the correct "dev" version
+ } else if (versionMatch && (versionValue === versionMatch[1])) {
+ // do nothing, we're already on the correct version
+ } else {
+ if (versionValue === "" && versionMatch) {
+ window.location.pathname = "ditto/" + versionMatch[2];
+ } else if (versionValue === "") {
+ window.location.pathname = "ditto/" + remainingPath;
+ } else if (versionMatch) {
+ window.location.pathname = "ditto/" + versionValue + "/" + versionMatch[2];
+ } else {
+ window.location.pathname = "ditto/" + versionValue + "/" + remainingPath;
+ }
+ }
+}
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Retrieve resources</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+
+
+
+<!-- this handles the automatic toc. use ## for subheads to auto-generate the on-page minitoc. if you use html tags, you must supply an ID for the heading element in order for it to appear in the minitoc. -->
+<script>
+$( document ).ready(function() {
+ // Handler for .ready() called.
+
+$('#toc').toc({ minimumHeaders: 0, listType: 'ul', showSpeed: 0, headers: 'h2,h3,h4' });
+
+/* this offset helps account for the space taken up by the floating toolbar. */
+$('#toc').on('click', 'a', function() {
+ var target = $(this.getAttribute('href'))
+ , scroll_target = target.offset().top
+
+ $(window).scrollTop(scroll_target - 10);
+ return false
+})
+
+});
+</script>
+
+<div id="toc"></div>
+
+
+
+
+
+
+
+
+
+
+<h2 id="retrieveresources">RetrieveResources</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/the_policy_id/policies/commands/retrieve"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/entries/the_label/resources"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="retrieveresourcesresponse">RetrieveResourcesResponse</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/the_policy_id/policies/commands/retrieve"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/entries/the_label/resources"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"thing:/the_resource_path"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"grant"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
+ </span><span class="s2">"READ"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"WRITE"</span><span class="w">
+ </span><span class="p">],</span><span class="w">
+ </span><span class="s2">"revoke"</span><span class="p">:</span><span class="w"> </span><span class="p">[]</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">200</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+
+
+ <div class="tags">
+
+ </div>
+
+</div>
+
+<hr class="shaded"/>
+
+<footer>
+ <div class="row">
+ <div class="col-lg-12 footer">
+ <div class="logo">
+ <a href="https://eclipse.org"><img src="images/eclipse_foundation_logo.svg" alt="Eclipse logo"/></a>
+ </div>
+ <p class="notice">
+ ©2020 Eclipse Ditto.
+ Site last generated: Jul 1, 2020 <br />
+ </p>
+ <div class="quickLinks">
+ <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
+ > Privacy Policy
+ </a>
+ <a href="https://www.eclipse.org/legal/termsofuse.php" target="_blank">
+ > Terms of Use
+ </a>
+ <a href="https://www.eclipse.org/legal/copyright.php" target="_blank">
+ > Copyright Agent
+ </a>
+ <a href="https://www.eclipse.org/legal" target="_blank">
+ > Legal
+ </a>
+ <a href="https://www.eclipse.org/legal/epl-2.0/" target="_blank">
+ > License
+ </a>
+ <a href="https://eclipse.org/security" target="_blank">
+ > Report a Vulnerability
+ </a>
+ </div>
+ </div>
+ </div>
+</footer>
+
+
+ </div>
+ <!-- /.row -->
+</div>
+<!-- /.container -->
+</div>
+<!-- /#main -->
+ </div>
+
+</body>
+</html>
diff --git a/1.0/protocol-examples-policies-retrievesubject.html b/1.0/protocol-examples-policies-retrievesubject.html
new file mode 100644
index 0000000..ad5b70b
--- /dev/null
+++ b/1.0/protocol-examples-policies-retrievesubject.html
@@ -0,0 +1,1553 @@
+<!DOCTYPE html>
+<html>
+<head>
+ <meta charset="utf-8">
+<meta http-equiv="X-UA-Compatible" content="IE=edge">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="description" content="">
+<meta name="keywords" content=" examples, retrieve subject">
+<title> Retrieve a subject • Eclipse Ditto • a digital twin framework</title>
+
+<link rel="stylesheet" href="css/syntax.css">
+<link rel="stylesheet" type="text/css" href="//cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/modern-business.css">
+<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/customstyles.css">
+<link rel="stylesheet" href="css/boxshadowproperties.css">
+<link rel="stylesheet" href="css/theme-ditto.css">
+<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:400,700|Source+Code+Pro:300,600|Titillium+Web:400,600,700">
+
+<script src="//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.4/jquery.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/js/bootstrap.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/anchor-js/2.0.0/anchor.min.js" crossorigin="anonymous"></script>
+<script src="js/toc.js"></script>
+<script src="js/customscripts.js"></script>
+
+<script type="application/ld+json">
+{
+ "@context": "http://schema.org",
+ "@type": "Organization",
+ "url": "https://eclipse.org/ditto/",
+ "logo": "https://eclipse.org/ditto/images/ditto.svg"
+}
+</script>
+
+<link rel="icon" type="image/png" href="images/favicon-16x16.png" sizes="16x16">
+<link rel="icon" type="image/png" href="images/favicon-32x32.png" sizes="32x32">
+<link rel="icon" type="image/png" href="images/favicon-96x96.png" sizes="96x96">
+
+<link rel="alternate" type="application/rss+xml" title="Eclipse Ditto Blog" href="https://www.eclipse.org/ditto/feed.xml">
+
+<!-- Eclipse Foundation cookie consent: -->
+<link rel="stylesheet" type="text/css" href="//www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css" />
+<script src="//www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+ <script>
+ $(document).ready(function() {
+ $("#tg-sb-link").click(function() {
+ $("#tg-sb-sidebar").toggle();
+ $("#tg-sb-content").toggleClass('col-md-9');
+ $("#tg-sb-content").toggleClass('col-md-12');
+ $("#tg-sb-icon").toggleClass('fa-toggle-on');
+ $("#tg-sb-icon").toggleClass('fa-toggle-off');
+ });
+ });
+ </script>
+</head>
+
+
+<script>
+ (function(w,d,s,l,i){
+ w[l]=w[l]||[];
+ w[l].push({'gtm.start':
+ new Date().getTime(),event:'gtm.js'});
+ var f=d.getElementsByTagName(s)[0],
+ j=d.createElement(s),
+ dl=l!='dataLayer'?'&l='+l:'';
+ j.async=true;
+ j.src='https://www.googletagmanager.com/gtm.js?id='+i+dl;
+ f.parentNode.insertBefore(j,f);
+ })(window,document,'script','dataLayer','GTM-5WLCZXC');
+</script>
+
+
+
+<body>
+<!-- Navigation -->
+<nav class="navbar navbar-inverse navbar-fixed-top">
+ <div class="container topnavlinks">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-ditto-home" href="index.html"> <img src="images/ditto_allwhite_symbolonly.svg" class="ditto-navbar-symbol" alt="Home"> <img src="images/ditto_allwhite_textonly.svg" class="ditto-navbar-symbol-text" alt="Ditto"></a>
+ </div>
+ <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
+ <ul class="nav navbar-nav navbar-right">
+ <!-- toggle sidebar button -->
+ <!--<li><a id="tg-sb-link" href="#"><i id="tg-sb-icon" class="fa fa-toggle-on"></i> Nav</a></li>-->
+ <!-- entries without drop-downs appear here -->
+
+
+
+
+
+
+
+ <li><a href="blog.html">Blog</a></li>
+
+
+
+ <li><a href="intro-overview.html">Documentation</a></li>
+
+
+
+ <li><a href="http-api-doc.html">HTTP API</a></li>
+
+
+
+ <li><a href="https://ditto.eclipse.org" target="_blank">Sandbox</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">GitHub</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">GitHub examples</a></li>
+
+
+
+ <!-- entries with drop-downs appear here -->
+ <!-- conditional logic to control which topnav appears for the audience defined in the configuration file.-->
+
+
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Links<b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+
+ <li><a href="https://projects.eclipse.org/projects/iot.ditto" target="_blank">Eclipse Ditto Project</a></li>
+
+
+
+ <li><a href="https://www.eclipse.org/forums/index.php/f/364/" target="_blank">Forum</a></li>
+
+
+
+ <li><a href="https://ci.eclipse.org/ditto/" target="_blank">Jenkins</a></li>
+
+
+
+ <li><a href="https://dev.eclipse.org/mhonarc/lists/ditto-dev/" target="_blank">Mailing list archives</a></li>
+
+
+
+ <li><a href="https://gitter.im/eclipse/ditto" target="_blank">Gitter.im chat</a></li>
+
+
+ </ul>
+ </li>
+
+
+
+ <!--comment out this block if you want to hide search-->
+ <li>
+ <!--start search-->
+ <div id="search-demo-container">
+ <input type="text" id="search-input" placeholder="search...">
+ <ul id="results-container"></ul>
+ </div>
+ <script src="//cdnjs.cloudflare.com/ajax/libs/simple-jekyll-search/0.0.9/jekyll-search.js" type="text/javascript"></script>
+ <script type="text/javascript">
+ SimpleJekyllSearch.init({
+ searchInput: document.getElementById('search-input'),
+ resultsContainer: document.getElementById('results-container'),
+ dataSource: 'search.json',
+ searchResultTemplate: '<li><a href="{url}" title="Retrieve a subject">{title}</a></li>',
+ noResultsText: 'No results found.',
+ limit: 10,
+ fuzzy: true,
+ })
+ </script>
+ <!--end search-->
+ </li>
+ </ul>
+ </div>
+ </div>
+ <!-- /.container -->
+</nav>
+
+<!-- Page Content -->
+<div class="container">
+ <div id="main">
+ <!-- Content Row -->
+ <div class="row">
+
+
+ <!-- Sidebar Column -->
+ <div class="col-md-3" id="tg-sb-sidebar">
+
+
+<ul id="mysidebar" class="nav">
+ <li class="sidebarTitle">
+ <label for="docVersion">Eclipse Ditto version:</label>
+ <div class="select-wrapper">
+ <select id="docVersion" name="docVersion">
+
+ <option value="">development</option>
+
+ <option value="1.0">1.0</option>
+
+ <option value="1.1">1.1</option>
+
+ </select>
+ </div>
+ <div id="dev-warning">
+ <div markdown="span" class="alert alert-warning" role="alert" style="font-size:0.6em"><i class="fa fa-warning"></i> <b>Important:</b> This documentation reflects the latest 'development'. You might want to choose a released version.</div>
+ </div>
+ </li>
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Introduction</a>
+ <ul>
+
+
+
+ <li><a href="intro-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="intro-digitaltwins.html">Digital twins</a></li>
+
+
+
+
+
+
+ <li><a href="intro-hello-world.html">Hello world</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Release Notes</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_100.html">1.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_090.html">0.9.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_080.html">0.8.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Milestone releases</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_100-M2.html">1.0.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_100-M1a.html">1.0.0-M1a</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M2.html">0.9.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M1.html">0.9.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M3.html">0.8.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M2.html">0.8.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M1.html">0.8.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M2.html">0.3.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M1.html">0.3.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_020-M1.html">0.2.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M3.html">0.1.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M1.html">0.1.0-M1</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Installation</a>
+ <ul>
+
+
+
+ <li><a href="installation-building.html">Building Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-running.html">Running Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-operating.html">Operating Ditto</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Basic concepts</a>
+ <ul>
+
+
+
+ <li><a href="basic-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Model entities</a>
+ <ul>
+
+
+
+ <li><a href="basic-thing.html">Thing</a></li>
+
+
+
+
+
+ <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
+
+
+
+
+
+ <li><a href="basic-feature.html">Feature</a></li>
+
+
+
+
+
+ <li><a href="basic-policy.html">Policy</a></li>
+
+
+
+
+
+ <li><a href="basic-namespaces-and-names.html">Namespaces and Names</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-auth.html">Authentication and Authorization</a></li>
+
+
+
+
+
+
+ <li><a href="basic-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="basic-signals.html">Signals</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Signal types</a>
+ <ul>
+
+
+
+ <li><a href="basic-signals-command.html">Command</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-commandresponse.html">Command response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-errorresponse.html">Error response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-event.html">Event</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-apis.html">APIs</a></li>
+
+
+
+
+
+
+ <li><a href="basic-connections.html">Connections</a></li>
+
+
+
+
+
+
+ <li><a href="basic-placeholders.html">Placeholders</a></li>
+
+
+
+
+
+
+ <li><a href="basic-changenotifications.html">Change notifications</a></li>
+
+
+
+
+
+
+ <li><a href="basic-rql.html">RQL expressions</a></li>
+
+
+
+
+
+
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
+ <li><a href="basic-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Architecture</a>
+ <ul>
+
+
+
+ <li><a href="architecture-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Services</a>
+ <ul>
+
+
+
+ <li><a href="architecture-services-policies.html">Policies</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things.html">Things</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things-search.html">Things-Search</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-connectivity.html">Connectivity</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-concierge.html">Concierge</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-gateway.html">Gateway</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>HTTP API</a>
+ <ul>
+
+
+
+ <li><a href="httpapi-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-concepts.html">Concepts</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-protocol-bindings-websocket.html">WebSocket protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-sse.html">Server sent events</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Connectivity API</a>
+ <ul>
+
+
+
+ <li><a href="connectivity-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-manage-connections.html">Manage connections</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp091.html">AMQP 0.9.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp10.html">AMQP 1.0 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-kafka2.html">Kafka 2.x protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-mapping.html">Payload mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-header-mapping.html">Header mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-tls-certificates.html">TLS certificates</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Client SDK</a>
+ <ul>
+
+
+
+ <li><a href="client-sdk-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-java.html">Java</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-javascript.html">JavaScript</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Ditto Protocol</a>
+ <ul>
+
+
+
+ <li><a href="protocol-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-twinlive.html">Twin/live channel</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification.html">Specification</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-topic.html">Protocol topic</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-things.html">Things group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-delete.html">Delete</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ search/messages</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-search.html">Search</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-messages.html">Messages</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-bindings.html">Bindings</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-examples.html">Examples</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-creatething.html">Create a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletething.html">Delete a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifything.html">Modify a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievething.html">Retrieve a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethings.html">Retrieve multiple Things</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattributes.html">Delete Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattributes.html">Modify Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattributes.html">Retrieve Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattribute.html">Create a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattribute.html">Delete a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattribute.html">Modify a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattribute.html">Retrieve a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createthingdefinition.html">Create a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletethingdefinition.html">Delete a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifythingdefinition.html">Modify a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethingdefinition.html">Retrieve a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeatures.html">Create Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeatures.html">Delete Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeatures.html">Modify Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeatures.html">Retrieve Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeature.html">Create a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeature.html">Delete a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeature.html">Modify a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeature.html">Retrieve a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdefinition.html">Create Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedefinition.html">Delete Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydefinition.html">Modify Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedefinition.html">Retrieve Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperties.html">Create Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperties.html">Delete Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperties.html">Modify Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperties.html">Retrieve Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperty.html">Create a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperty.html">Delete a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperty.html">Modify a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperty.html">Retrieve a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li class="active"><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li><a href="sandbox.html">Sandbox</a></li>
+
+
+
+
+
+ <li><a href="presentations.html">Presentations</a></li>
+
+
+
+
+
+ <li><a href="glossary.html">Glossary</a></li>
+
+
+
+
+
+ <li><a href="feedback.html">Feedback</a></li>
+
+
+
+
+
+ <p class="external">
+ <a href="#" id="collapseAll">Collapse All</a> | <a href="#" id="expandAll">Expand All</a>
+ </p>
+
+</ul>
+
+<!-- this highlights the active parent class in the sidebar. this is critical so that the parent expands when you're viewing a page. This must appear below the sidebar code above. Otherwise, if placed inside customscripts.js, the script runs before the sidebar code runs and the class never gets inserted.-->
+<script>$("li.active").parents('li').toggleClass("active");
+
+$(function() {
+ $("#dev-warning").hide();
+ changeSelectedDocVersionDropdownSelection($("#docVersion")[0]);
+ $("#docVersion").change(changeSelectedDocVersion);
+});
+
+function changeSelectedDocVersionDropdownSelection(element) {
+ var pathName = window.location.pathname;
+
+ var versionOptions = element.options;
+ for (var i = 0; i < versionOptions.length; i++) {
+ var versionValue = versionOptions[i].value;
+ if ((versionValue !== "") && pathName.startsWith("/ditto/"+versionValue+"/")) {
+ $("#docVersion").val(versionValue).change();
+ return;
+ }
+ }
+ // fallback: dev with "empty" version value:
+ $("#docVersion").val("").change();
+ $("#dev-warning").show();
+}
+function changeSelectedDocVersion() {
+ var versionValue = $('#docVersion').val();
+ var remainingPath = window.location.pathname.replace("/ditto/", "");
+ var versionMatch = remainingPath.match("([0-9].[0.9])/(.*)");
+ if (versionValue === "" && !versionMatch) {
+ // do nothing, we're already on the correct "dev" version
+ } else if (versionMatch && (versionValue === versionMatch[1])) {
+ // do nothing, we're already on the correct version
+ } else {
+ if (versionValue === "" && versionMatch) {
+ window.location.pathname = "ditto/" + versionMatch[2];
+ } else if (versionValue === "") {
+ window.location.pathname = "ditto/" + remainingPath;
+ } else if (versionMatch) {
+ window.location.pathname = "ditto/" + versionValue + "/" + versionMatch[2];
+ } else {
+ window.location.pathname = "ditto/" + versionValue + "/" + remainingPath;
+ }
+ }
+}
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Retrieve a subject</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+
+
+
+<!-- this handles the automatic toc. use ## for subheads to auto-generate the on-page minitoc. if you use html tags, you must supply an ID for the heading element in order for it to appear in the minitoc. -->
+<script>
+$( document ).ready(function() {
+ // Handler for .ready() called.
+
+$('#toc').toc({ minimumHeaders: 0, listType: 'ul', showSpeed: 0, headers: 'h2,h3,h4' });
+
+/* this offset helps account for the space taken up by the floating toolbar. */
+$('#toc').on('click', 'a', function() {
+ var target = $(this.getAttribute('href'))
+ , scroll_target = target.offset().top
+
+ $(window).scrollTop(scroll_target - 10);
+ return false
+})
+
+});
+</script>
+
+<div id="toc"></div>
+
+
+
+
+
+
+
+
+
+
+<h2 id="retrievesubject">RetrieveSubject</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/the_policy_id/policies/commands/retrieve"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/entries/the_label/subjects/google:the_subjectid"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="retrievesubjectresponse">RetrieveSubjectResponse</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/the_policy_id/policies/commands/retrieve"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/entries/the_label/subjects/google:the_subjectid"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"yourSubjectTypeDescription"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">200</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+
+
+ <div class="tags">
+
+ </div>
+
+</div>
+
+<hr class="shaded"/>
+
+<footer>
+ <div class="row">
+ <div class="col-lg-12 footer">
+ <div class="logo">
+ <a href="https://eclipse.org"><img src="images/eclipse_foundation_logo.svg" alt="Eclipse logo"/></a>
+ </div>
+ <p class="notice">
+ ©2020 Eclipse Ditto.
+ Site last generated: Jul 1, 2020 <br />
+ </p>
+ <div class="quickLinks">
+ <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
+ > Privacy Policy
+ </a>
+ <a href="https://www.eclipse.org/legal/termsofuse.php" target="_blank">
+ > Terms of Use
+ </a>
+ <a href="https://www.eclipse.org/legal/copyright.php" target="_blank">
+ > Copyright Agent
+ </a>
+ <a href="https://www.eclipse.org/legal" target="_blank">
+ > Legal
+ </a>
+ <a href="https://www.eclipse.org/legal/epl-2.0/" target="_blank">
+ > License
+ </a>
+ <a href="https://eclipse.org/security" target="_blank">
+ > Report a Vulnerability
+ </a>
+ </div>
+ </div>
+ </div>
+</footer>
+
+
+ </div>
+ <!-- /.row -->
+</div>
+<!-- /.container -->
+</div>
+<!-- /#main -->
+ </div>
+
+</body>
+</html>
diff --git a/1.0/protocol-examples-policies-retrievesubjects.html b/1.0/protocol-examples-policies-retrievesubjects.html
new file mode 100644
index 0000000..55bde82
--- /dev/null
+++ b/1.0/protocol-examples-policies-retrievesubjects.html
@@ -0,0 +1,1555 @@
+<!DOCTYPE html>
+<html>
+<head>
+ <meta charset="utf-8">
+<meta http-equiv="X-UA-Compatible" content="IE=edge">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="description" content="">
+<meta name="keywords" content=" examples, retrieve subjects">
+<title> Retrieve subjects • Eclipse Ditto • a digital twin framework</title>
+
+<link rel="stylesheet" href="css/syntax.css">
+<link rel="stylesheet" type="text/css" href="//cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/modern-business.css">
+<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/customstyles.css">
+<link rel="stylesheet" href="css/boxshadowproperties.css">
+<link rel="stylesheet" href="css/theme-ditto.css">
+<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:400,700|Source+Code+Pro:300,600|Titillium+Web:400,600,700">
+
+<script src="//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.4/jquery.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/js/bootstrap.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/anchor-js/2.0.0/anchor.min.js" crossorigin="anonymous"></script>
+<script src="js/toc.js"></script>
+<script src="js/customscripts.js"></script>
+
+<script type="application/ld+json">
+{
+ "@context": "http://schema.org",
+ "@type": "Organization",
+ "url": "https://eclipse.org/ditto/",
+ "logo": "https://eclipse.org/ditto/images/ditto.svg"
+}
+</script>
+
+<link rel="icon" type="image/png" href="images/favicon-16x16.png" sizes="16x16">
+<link rel="icon" type="image/png" href="images/favicon-32x32.png" sizes="32x32">
+<link rel="icon" type="image/png" href="images/favicon-96x96.png" sizes="96x96">
+
+<link rel="alternate" type="application/rss+xml" title="Eclipse Ditto Blog" href="https://www.eclipse.org/ditto/feed.xml">
+
+<!-- Eclipse Foundation cookie consent: -->
+<link rel="stylesheet" type="text/css" href="//www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css" />
+<script src="//www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+ <script>
+ $(document).ready(function() {
+ $("#tg-sb-link").click(function() {
+ $("#tg-sb-sidebar").toggle();
+ $("#tg-sb-content").toggleClass('col-md-9');
+ $("#tg-sb-content").toggleClass('col-md-12');
+ $("#tg-sb-icon").toggleClass('fa-toggle-on');
+ $("#tg-sb-icon").toggleClass('fa-toggle-off');
+ });
+ });
+ </script>
+</head>
+
+
+<script>
+ (function(w,d,s,l,i){
+ w[l]=w[l]||[];
+ w[l].push({'gtm.start':
+ new Date().getTime(),event:'gtm.js'});
+ var f=d.getElementsByTagName(s)[0],
+ j=d.createElement(s),
+ dl=l!='dataLayer'?'&l='+l:'';
+ j.async=true;
+ j.src='https://www.googletagmanager.com/gtm.js?id='+i+dl;
+ f.parentNode.insertBefore(j,f);
+ })(window,document,'script','dataLayer','GTM-5WLCZXC');
+</script>
+
+
+
+<body>
+<!-- Navigation -->
+<nav class="navbar navbar-inverse navbar-fixed-top">
+ <div class="container topnavlinks">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-ditto-home" href="index.html"> <img src="images/ditto_allwhite_symbolonly.svg" class="ditto-navbar-symbol" alt="Home"> <img src="images/ditto_allwhite_textonly.svg" class="ditto-navbar-symbol-text" alt="Ditto"></a>
+ </div>
+ <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
+ <ul class="nav navbar-nav navbar-right">
+ <!-- toggle sidebar button -->
+ <!--<li><a id="tg-sb-link" href="#"><i id="tg-sb-icon" class="fa fa-toggle-on"></i> Nav</a></li>-->
+ <!-- entries without drop-downs appear here -->
+
+
+
+
+
+
+
+ <li><a href="blog.html">Blog</a></li>
+
+
+
+ <li><a href="intro-overview.html">Documentation</a></li>
+
+
+
+ <li><a href="http-api-doc.html">HTTP API</a></li>
+
+
+
+ <li><a href="https://ditto.eclipse.org" target="_blank">Sandbox</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">GitHub</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">GitHub examples</a></li>
+
+
+
+ <!-- entries with drop-downs appear here -->
+ <!-- conditional logic to control which topnav appears for the audience defined in the configuration file.-->
+
+
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Links<b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+
+ <li><a href="https://projects.eclipse.org/projects/iot.ditto" target="_blank">Eclipse Ditto Project</a></li>
+
+
+
+ <li><a href="https://www.eclipse.org/forums/index.php/f/364/" target="_blank">Forum</a></li>
+
+
+
+ <li><a href="https://ci.eclipse.org/ditto/" target="_blank">Jenkins</a></li>
+
+
+
+ <li><a href="https://dev.eclipse.org/mhonarc/lists/ditto-dev/" target="_blank">Mailing list archives</a></li>
+
+
+
+ <li><a href="https://gitter.im/eclipse/ditto" target="_blank">Gitter.im chat</a></li>
+
+
+ </ul>
+ </li>
+
+
+
+ <!--comment out this block if you want to hide search-->
+ <li>
+ <!--start search-->
+ <div id="search-demo-container">
+ <input type="text" id="search-input" placeholder="search...">
+ <ul id="results-container"></ul>
+ </div>
+ <script src="//cdnjs.cloudflare.com/ajax/libs/simple-jekyll-search/0.0.9/jekyll-search.js" type="text/javascript"></script>
+ <script type="text/javascript">
+ SimpleJekyllSearch.init({
+ searchInput: document.getElementById('search-input'),
+ resultsContainer: document.getElementById('results-container'),
+ dataSource: 'search.json',
+ searchResultTemplate: '<li><a href="{url}" title="Retrieve subjects">{title}</a></li>',
+ noResultsText: 'No results found.',
+ limit: 10,
+ fuzzy: true,
+ })
+ </script>
+ <!--end search-->
+ </li>
+ </ul>
+ </div>
+ </div>
+ <!-- /.container -->
+</nav>
+
+<!-- Page Content -->
+<div class="container">
+ <div id="main">
+ <!-- Content Row -->
+ <div class="row">
+
+
+ <!-- Sidebar Column -->
+ <div class="col-md-3" id="tg-sb-sidebar">
+
+
+<ul id="mysidebar" class="nav">
+ <li class="sidebarTitle">
+ <label for="docVersion">Eclipse Ditto version:</label>
+ <div class="select-wrapper">
+ <select id="docVersion" name="docVersion">
+
+ <option value="">development</option>
+
+ <option value="1.0">1.0</option>
+
+ <option value="1.1">1.1</option>
+
+ </select>
+ </div>
+ <div id="dev-warning">
+ <div markdown="span" class="alert alert-warning" role="alert" style="font-size:0.6em"><i class="fa fa-warning"></i> <b>Important:</b> This documentation reflects the latest 'development'. You might want to choose a released version.</div>
+ </div>
+ </li>
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Introduction</a>
+ <ul>
+
+
+
+ <li><a href="intro-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="intro-digitaltwins.html">Digital twins</a></li>
+
+
+
+
+
+
+ <li><a href="intro-hello-world.html">Hello world</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Release Notes</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_100.html">1.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_090.html">0.9.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_080.html">0.8.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Milestone releases</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_100-M2.html">1.0.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_100-M1a.html">1.0.0-M1a</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M2.html">0.9.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M1.html">0.9.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M3.html">0.8.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M2.html">0.8.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M1.html">0.8.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M2.html">0.3.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M1.html">0.3.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_020-M1.html">0.2.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M3.html">0.1.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M1.html">0.1.0-M1</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Installation</a>
+ <ul>
+
+
+
+ <li><a href="installation-building.html">Building Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-running.html">Running Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-operating.html">Operating Ditto</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Basic concepts</a>
+ <ul>
+
+
+
+ <li><a href="basic-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Model entities</a>
+ <ul>
+
+
+
+ <li><a href="basic-thing.html">Thing</a></li>
+
+
+
+
+
+ <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
+
+
+
+
+
+ <li><a href="basic-feature.html">Feature</a></li>
+
+
+
+
+
+ <li><a href="basic-policy.html">Policy</a></li>
+
+
+
+
+
+ <li><a href="basic-namespaces-and-names.html">Namespaces and Names</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-auth.html">Authentication and Authorization</a></li>
+
+
+
+
+
+
+ <li><a href="basic-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="basic-signals.html">Signals</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Signal types</a>
+ <ul>
+
+
+
+ <li><a href="basic-signals-command.html">Command</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-commandresponse.html">Command response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-errorresponse.html">Error response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-event.html">Event</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-apis.html">APIs</a></li>
+
+
+
+
+
+
+ <li><a href="basic-connections.html">Connections</a></li>
+
+
+
+
+
+
+ <li><a href="basic-placeholders.html">Placeholders</a></li>
+
+
+
+
+
+
+ <li><a href="basic-changenotifications.html">Change notifications</a></li>
+
+
+
+
+
+
+ <li><a href="basic-rql.html">RQL expressions</a></li>
+
+
+
+
+
+
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
+ <li><a href="basic-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Architecture</a>
+ <ul>
+
+
+
+ <li><a href="architecture-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Services</a>
+ <ul>
+
+
+
+ <li><a href="architecture-services-policies.html">Policies</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things.html">Things</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things-search.html">Things-Search</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-connectivity.html">Connectivity</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-concierge.html">Concierge</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-gateway.html">Gateway</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>HTTP API</a>
+ <ul>
+
+
+
+ <li><a href="httpapi-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-concepts.html">Concepts</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-protocol-bindings-websocket.html">WebSocket protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-sse.html">Server sent events</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Connectivity API</a>
+ <ul>
+
+
+
+ <li><a href="connectivity-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-manage-connections.html">Manage connections</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp091.html">AMQP 0.9.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp10.html">AMQP 1.0 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-kafka2.html">Kafka 2.x protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-mapping.html">Payload mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-header-mapping.html">Header mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-tls-certificates.html">TLS certificates</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Client SDK</a>
+ <ul>
+
+
+
+ <li><a href="client-sdk-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-java.html">Java</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-javascript.html">JavaScript</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Ditto Protocol</a>
+ <ul>
+
+
+
+ <li><a href="protocol-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-twinlive.html">Twin/live channel</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification.html">Specification</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-topic.html">Protocol topic</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-things.html">Things group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-delete.html">Delete</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ search/messages</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-search.html">Search</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-messages.html">Messages</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-bindings.html">Bindings</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-examples.html">Examples</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-creatething.html">Create a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletething.html">Delete a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifything.html">Modify a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievething.html">Retrieve a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethings.html">Retrieve multiple Things</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattributes.html">Delete Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattributes.html">Modify Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattributes.html">Retrieve Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattribute.html">Create a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattribute.html">Delete a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattribute.html">Modify a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattribute.html">Retrieve a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createthingdefinition.html">Create a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletethingdefinition.html">Delete a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifythingdefinition.html">Modify a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethingdefinition.html">Retrieve a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeatures.html">Create Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeatures.html">Delete Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeatures.html">Modify Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeatures.html">Retrieve Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeature.html">Create a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeature.html">Delete a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeature.html">Modify a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeature.html">Retrieve a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdefinition.html">Create Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedefinition.html">Delete Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydefinition.html">Modify Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedefinition.html">Retrieve Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperties.html">Create Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperties.html">Delete Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperties.html">Modify Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperties.html">Retrieve Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperty.html">Create a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperty.html">Delete a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperty.html">Modify a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperty.html">Retrieve a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li class="active"><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li><a href="sandbox.html">Sandbox</a></li>
+
+
+
+
+
+ <li><a href="presentations.html">Presentations</a></li>
+
+
+
+
+
+ <li><a href="glossary.html">Glossary</a></li>
+
+
+
+
+
+ <li><a href="feedback.html">Feedback</a></li>
+
+
+
+
+
+ <p class="external">
+ <a href="#" id="collapseAll">Collapse All</a> | <a href="#" id="expandAll">Expand All</a>
+ </p>
+
+</ul>
+
+<!-- this highlights the active parent class in the sidebar. this is critical so that the parent expands when you're viewing a page. This must appear below the sidebar code above. Otherwise, if placed inside customscripts.js, the script runs before the sidebar code runs and the class never gets inserted.-->
+<script>$("li.active").parents('li').toggleClass("active");
+
+$(function() {
+ $("#dev-warning").hide();
+ changeSelectedDocVersionDropdownSelection($("#docVersion")[0]);
+ $("#docVersion").change(changeSelectedDocVersion);
+});
+
+function changeSelectedDocVersionDropdownSelection(element) {
+ var pathName = window.location.pathname;
+
+ var versionOptions = element.options;
+ for (var i = 0; i < versionOptions.length; i++) {
+ var versionValue = versionOptions[i].value;
+ if ((versionValue !== "") && pathName.startsWith("/ditto/"+versionValue+"/")) {
+ $("#docVersion").val(versionValue).change();
+ return;
+ }
+ }
+ // fallback: dev with "empty" version value:
+ $("#docVersion").val("").change();
+ $("#dev-warning").show();
+}
+function changeSelectedDocVersion() {
+ var versionValue = $('#docVersion').val();
+ var remainingPath = window.location.pathname.replace("/ditto/", "");
+ var versionMatch = remainingPath.match("([0-9].[0.9])/(.*)");
+ if (versionValue === "" && !versionMatch) {
+ // do nothing, we're already on the correct "dev" version
+ } else if (versionMatch && (versionValue === versionMatch[1])) {
+ // do nothing, we're already on the correct version
+ } else {
+ if (versionValue === "" && versionMatch) {
+ window.location.pathname = "ditto/" + versionMatch[2];
+ } else if (versionValue === "") {
+ window.location.pathname = "ditto/" + remainingPath;
+ } else if (versionMatch) {
+ window.location.pathname = "ditto/" + versionValue + "/" + versionMatch[2];
+ } else {
+ window.location.pathname = "ditto/" + versionValue + "/" + remainingPath;
+ }
+ }
+}
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Retrieve subjects</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+
+
+
+<!-- this handles the automatic toc. use ## for subheads to auto-generate the on-page minitoc. if you use html tags, you must supply an ID for the heading element in order for it to appear in the minitoc. -->
+<script>
+$( document ).ready(function() {
+ // Handler for .ready() called.
+
+$('#toc').toc({ minimumHeaders: 0, listType: 'ul', showSpeed: 0, headers: 'h2,h3,h4' });
+
+/* this offset helps account for the space taken up by the floating toolbar. */
+$('#toc').on('click', 'a', function() {
+ var target = $(this.getAttribute('href'))
+ , scroll_target = target.offset().top
+
+ $(window).scrollTop(scroll_target - 10);
+ return false
+})
+
+});
+</script>
+
+<div id="toc"></div>
+
+
+
+
+
+
+
+
+
+
+<h2 id="retrievesubjects">RetrieveSubjects</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/the_policy_id/policies/commands/retrieve"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/entries/the_label/subjects"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="retrievesubjectsresponse">RetrieveSubjectsResponse</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/the_policy_id/policies/commands/retrieve"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/entries/the_label/subjects"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"google:the_subjectid"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"yourSubjectTypeDescription"</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">200</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+
+
+ <div class="tags">
+
+ </div>
+
+</div>
+
+<hr class="shaded"/>
+
+<footer>
+ <div class="row">
+ <div class="col-lg-12 footer">
+ <div class="logo">
+ <a href="https://eclipse.org"><img src="images/eclipse_foundation_logo.svg" alt="Eclipse logo"/></a>
+ </div>
+ <p class="notice">
+ ©2020 Eclipse Ditto.
+ Site last generated: Jul 1, 2020 <br />
+ </p>
+ <div class="quickLinks">
+ <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
+ > Privacy Policy
+ </a>
+ <a href="https://www.eclipse.org/legal/termsofuse.php" target="_blank">
+ > Terms of Use
+ </a>
+ <a href="https://www.eclipse.org/legal/copyright.php" target="_blank">
+ > Copyright Agent
+ </a>
+ <a href="https://www.eclipse.org/legal" target="_blank">
+ > Legal
+ </a>
+ <a href="https://www.eclipse.org/legal/epl-2.0/" target="_blank">
+ > License
+ </a>
+ <a href="https://eclipse.org/security" target="_blank">
+ > Report a Vulnerability
+ </a>
+ </div>
+ </div>
+ </div>
+</footer>
+
+
+ </div>
+ <!-- /.row -->
+</div>
+<!-- /.container -->
+</div>
+<!-- /#main -->
+ </div>
+
+</body>
+</html>
diff --git a/1.0/protocol-examples-retrieveattribute.html b/1.0/protocol-examples-retrieveattribute.html
index 4e58a73..ad8db84 100644
--- a/1.0/protocol-examples-retrieveattribute.html
+++ b/1.0/protocol-examples-retrieveattribute.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1290,7 +1511,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-retrieveattributes.html b/1.0/protocol-examples-retrieveattributes.html
index 74f94c6..f569175 100644
--- a/1.0/protocol-examples-retrieveattributes.html
+++ b/1.0/protocol-examples-retrieveattributes.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1292,7 +1513,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-retrievedefinition.html b/1.0/protocol-examples-retrievedefinition.html
index 7d828b1..4e29b0c 100644
--- a/1.0/protocol-examples-retrievedefinition.html
+++ b/1.0/protocol-examples-retrievedefinition.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1289,7 +1510,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-retrievefeature.html b/1.0/protocol-examples-retrievefeature.html
index ec7d6b3..977ac37 100644
--- a/1.0/protocol-examples-retrievefeature.html
+++ b/1.0/protocol-examples-retrievefeature.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1294,7 +1515,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-retrievefeatures.html b/1.0/protocol-examples-retrievefeatures.html
index 795b2e4..af9788e 100644
--- a/1.0/protocol-examples-retrievefeatures.html
+++ b/1.0/protocol-examples-retrievefeatures.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1296,7 +1517,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-retrieveproperties.html b/1.0/protocol-examples-retrieveproperties.html
index 1d1488c..3bdd5dd 100644
--- a/1.0/protocol-examples-retrieveproperties.html
+++ b/1.0/protocol-examples-retrieveproperties.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1292,7 +1513,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-retrieveproperty.html b/1.0/protocol-examples-retrieveproperty.html
index d580045..0cbe82a 100644
--- a/1.0/protocol-examples-retrieveproperty.html
+++ b/1.0/protocol-examples-retrieveproperty.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1287,7 +1508,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-retrievething.html b/1.0/protocol-examples-retrievething.html
index 52040f9..53bea72 100644
--- a/1.0/protocol-examples-retrievething.html
+++ b/1.0/protocol-examples-retrievething.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1316,7 +1537,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-retrievethingdefinition.html b/1.0/protocol-examples-retrievethingdefinition.html
index dd34b64..46c0e34 100644
--- a/1.0/protocol-examples-retrievethingdefinition.html
+++ b/1.0/protocol-examples-retrievethingdefinition.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1287,7 +1508,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-retrievethings.html b/1.0/protocol-examples-retrievethings.html
index 0d6a774..f77c805 100644
--- a/1.0/protocol-examples-retrievethings.html
+++ b/1.0/protocol-examples-retrievethings.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1313,7 +1534,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-search.html b/1.0/protocol-examples-search.html
new file mode 100644
index 0000000..abf9c65
--- /dev/null
+++ b/1.0/protocol-examples-search.html
@@ -0,0 +1,1651 @@
+<!DOCTYPE html>
+<html>
+<head>
+ <meta charset="utf-8">
+<meta http-equiv="X-UA-Compatible" content="IE=edge">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="description" content="">
+<meta name="keywords" content=" examples, search">
+<title> Search protocol examples • Eclipse Ditto • a digital twin framework</title>
+
+<link rel="stylesheet" href="css/syntax.css">
+<link rel="stylesheet" type="text/css" href="//cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/modern-business.css">
+<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/customstyles.css">
+<link rel="stylesheet" href="css/boxshadowproperties.css">
+<link rel="stylesheet" href="css/theme-ditto.css">
+<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:400,700|Source+Code+Pro:300,600|Titillium+Web:400,600,700">
+
+<script src="//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.4/jquery.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/js/bootstrap.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/anchor-js/2.0.0/anchor.min.js" crossorigin="anonymous"></script>
+<script src="js/toc.js"></script>
+<script src="js/customscripts.js"></script>
+
+<script type="application/ld+json">
+{
+ "@context": "http://schema.org",
+ "@type": "Organization",
+ "url": "https://eclipse.org/ditto/",
+ "logo": "https://eclipse.org/ditto/images/ditto.svg"
+}
+</script>
+
+<link rel="icon" type="image/png" href="images/favicon-16x16.png" sizes="16x16">
+<link rel="icon" type="image/png" href="images/favicon-32x32.png" sizes="32x32">
+<link rel="icon" type="image/png" href="images/favicon-96x96.png" sizes="96x96">
+
+<link rel="alternate" type="application/rss+xml" title="Eclipse Ditto Blog" href="https://www.eclipse.org/ditto/feed.xml">
+
+<!-- Eclipse Foundation cookie consent: -->
+<link rel="stylesheet" type="text/css" href="//www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css" />
+<script src="//www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+ <script>
+ $(document).ready(function() {
+ $("#tg-sb-link").click(function() {
+ $("#tg-sb-sidebar").toggle();
+ $("#tg-sb-content").toggleClass('col-md-9');
+ $("#tg-sb-content").toggleClass('col-md-12');
+ $("#tg-sb-icon").toggleClass('fa-toggle-on');
+ $("#tg-sb-icon").toggleClass('fa-toggle-off');
+ });
+ });
+ </script>
+</head>
+
+
+<script>
+ (function(w,d,s,l,i){
+ w[l]=w[l]||[];
+ w[l].push({'gtm.start':
+ new Date().getTime(),event:'gtm.js'});
+ var f=d.getElementsByTagName(s)[0],
+ j=d.createElement(s),
+ dl=l!='dataLayer'?'&l='+l:'';
+ j.async=true;
+ j.src='https://www.googletagmanager.com/gtm.js?id='+i+dl;
+ f.parentNode.insertBefore(j,f);
+ })(window,document,'script','dataLayer','GTM-5WLCZXC');
+</script>
+
+
+
+<body>
+<!-- Navigation -->
+<nav class="navbar navbar-inverse navbar-fixed-top">
+ <div class="container topnavlinks">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-ditto-home" href="index.html"> <img src="images/ditto_allwhite_symbolonly.svg" class="ditto-navbar-symbol" alt="Home"> <img src="images/ditto_allwhite_textonly.svg" class="ditto-navbar-symbol-text" alt="Ditto"></a>
+ </div>
+ <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
+ <ul class="nav navbar-nav navbar-right">
+ <!-- toggle sidebar button -->
+ <!--<li><a id="tg-sb-link" href="#"><i id="tg-sb-icon" class="fa fa-toggle-on"></i> Nav</a></li>-->
+ <!-- entries without drop-downs appear here -->
+
+
+
+
+
+
+
+ <li><a href="blog.html">Blog</a></li>
+
+
+
+ <li><a href="intro-overview.html">Documentation</a></li>
+
+
+
+ <li><a href="http-api-doc.html">HTTP API</a></li>
+
+
+
+ <li><a href="https://ditto.eclipse.org" target="_blank">Sandbox</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">GitHub</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">GitHub examples</a></li>
+
+
+
+ <!-- entries with drop-downs appear here -->
+ <!-- conditional logic to control which topnav appears for the audience defined in the configuration file.-->
+
+
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Links<b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+
+ <li><a href="https://projects.eclipse.org/projects/iot.ditto" target="_blank">Eclipse Ditto Project</a></li>
+
+
+
+ <li><a href="https://www.eclipse.org/forums/index.php/f/364/" target="_blank">Forum</a></li>
+
+
+
+ <li><a href="https://ci.eclipse.org/ditto/" target="_blank">Jenkins</a></li>
+
+
+
+ <li><a href="https://dev.eclipse.org/mhonarc/lists/ditto-dev/" target="_blank">Mailing list archives</a></li>
+
+
+
+ <li><a href="https://gitter.im/eclipse/ditto" target="_blank">Gitter.im chat</a></li>
+
+
+ </ul>
+ </li>
+
+
+
+ <!--comment out this block if you want to hide search-->
+ <li>
+ <!--start search-->
+ <div id="search-demo-container">
+ <input type="text" id="search-input" placeholder="search...">
+ <ul id="results-container"></ul>
+ </div>
+ <script src="//cdnjs.cloudflare.com/ajax/libs/simple-jekyll-search/0.0.9/jekyll-search.js" type="text/javascript"></script>
+ <script type="text/javascript">
+ SimpleJekyllSearch.init({
+ searchInput: document.getElementById('search-input'),
+ resultsContainer: document.getElementById('results-container'),
+ dataSource: 'search.json',
+ searchResultTemplate: '<li><a href="{url}" title="Search protocol examples">{title}</a></li>',
+ noResultsText: 'No results found.',
+ limit: 10,
+ fuzzy: true,
+ })
+ </script>
+ <!--end search-->
+ </li>
+ </ul>
+ </div>
+ </div>
+ <!-- /.container -->
+</nav>
+
+<!-- Page Content -->
+<div class="container">
+ <div id="main">
+ <!-- Content Row -->
+ <div class="row">
+
+
+ <!-- Sidebar Column -->
+ <div class="col-md-3" id="tg-sb-sidebar">
+
+
+<ul id="mysidebar" class="nav">
+ <li class="sidebarTitle">
+ <label for="docVersion">Eclipse Ditto version:</label>
+ <div class="select-wrapper">
+ <select id="docVersion" name="docVersion">
+
+ <option value="">development</option>
+
+ <option value="1.0">1.0</option>
+
+ <option value="1.1">1.1</option>
+
+ </select>
+ </div>
+ <div id="dev-warning">
+ <div markdown="span" class="alert alert-warning" role="alert" style="font-size:0.6em"><i class="fa fa-warning"></i> <b>Important:</b> This documentation reflects the latest 'development'. You might want to choose a released version.</div>
+ </div>
+ </li>
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Introduction</a>
+ <ul>
+
+
+
+ <li><a href="intro-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="intro-digitaltwins.html">Digital twins</a></li>
+
+
+
+
+
+
+ <li><a href="intro-hello-world.html">Hello world</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Release Notes</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_100.html">1.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_090.html">0.9.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_080.html">0.8.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Milestone releases</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_100-M2.html">1.0.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_100-M1a.html">1.0.0-M1a</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M2.html">0.9.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M1.html">0.9.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M3.html">0.8.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M2.html">0.8.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M1.html">0.8.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M2.html">0.3.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M1.html">0.3.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_020-M1.html">0.2.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M3.html">0.1.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M1.html">0.1.0-M1</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Installation</a>
+ <ul>
+
+
+
+ <li><a href="installation-building.html">Building Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-running.html">Running Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-operating.html">Operating Ditto</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Basic concepts</a>
+ <ul>
+
+
+
+ <li><a href="basic-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Model entities</a>
+ <ul>
+
+
+
+ <li><a href="basic-thing.html">Thing</a></li>
+
+
+
+
+
+ <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
+
+
+
+
+
+ <li><a href="basic-feature.html">Feature</a></li>
+
+
+
+
+
+ <li><a href="basic-policy.html">Policy</a></li>
+
+
+
+
+
+ <li><a href="basic-namespaces-and-names.html">Namespaces and Names</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-auth.html">Authentication and Authorization</a></li>
+
+
+
+
+
+
+ <li><a href="basic-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="basic-signals.html">Signals</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Signal types</a>
+ <ul>
+
+
+
+ <li><a href="basic-signals-command.html">Command</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-commandresponse.html">Command response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-errorresponse.html">Error response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-event.html">Event</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-apis.html">APIs</a></li>
+
+
+
+
+
+
+ <li><a href="basic-connections.html">Connections</a></li>
+
+
+
+
+
+
+ <li><a href="basic-placeholders.html">Placeholders</a></li>
+
+
+
+
+
+
+ <li><a href="basic-changenotifications.html">Change notifications</a></li>
+
+
+
+
+
+
+ <li><a href="basic-rql.html">RQL expressions</a></li>
+
+
+
+
+
+
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
+ <li><a href="basic-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Architecture</a>
+ <ul>
+
+
+
+ <li><a href="architecture-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Services</a>
+ <ul>
+
+
+
+ <li><a href="architecture-services-policies.html">Policies</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things.html">Things</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things-search.html">Things-Search</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-connectivity.html">Connectivity</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-concierge.html">Concierge</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-gateway.html">Gateway</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>HTTP API</a>
+ <ul>
+
+
+
+ <li><a href="httpapi-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-concepts.html">Concepts</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-protocol-bindings-websocket.html">WebSocket protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-sse.html">Server sent events</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Connectivity API</a>
+ <ul>
+
+
+
+ <li><a href="connectivity-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-manage-connections.html">Manage connections</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp091.html">AMQP 0.9.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp10.html">AMQP 1.0 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-kafka2.html">Kafka 2.x protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-mapping.html">Payload mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-header-mapping.html">Header mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-tls-certificates.html">TLS certificates</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Client SDK</a>
+ <ul>
+
+
+
+ <li><a href="client-sdk-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-java.html">Java</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-javascript.html">JavaScript</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Ditto Protocol</a>
+ <ul>
+
+
+
+ <li><a href="protocol-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-twinlive.html">Twin/live channel</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification.html">Specification</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-topic.html">Protocol topic</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-things.html">Things group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-delete.html">Delete</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ search/messages</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-search.html">Search</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-messages.html">Messages</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-bindings.html">Bindings</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-examples.html">Examples</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-creatething.html">Create a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletething.html">Delete a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifything.html">Modify a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievething.html">Retrieve a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethings.html">Retrieve multiple Things</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattributes.html">Delete Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattributes.html">Modify Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattributes.html">Retrieve Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattribute.html">Create a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattribute.html">Delete a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattribute.html">Modify a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattribute.html">Retrieve a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createthingdefinition.html">Create a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletethingdefinition.html">Delete a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifythingdefinition.html">Modify a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethingdefinition.html">Retrieve a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeatures.html">Create Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeatures.html">Delete Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeatures.html">Modify Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeatures.html">Retrieve Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeature.html">Create a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeature.html">Delete a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeature.html">Modify a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeature.html">Retrieve a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdefinition.html">Create Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedefinition.html">Delete Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydefinition.html">Modify Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedefinition.html">Retrieve Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperties.html">Create Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperties.html">Delete Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperties.html">Modify Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperties.html">Retrieve Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperty.html">Create a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperty.html">Delete a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperty.html">Modify a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperty.html">Retrieve a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li class="active"><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li><a href="sandbox.html">Sandbox</a></li>
+
+
+
+
+
+ <li><a href="presentations.html">Presentations</a></li>
+
+
+
+
+
+ <li><a href="glossary.html">Glossary</a></li>
+
+
+
+
+
+ <li><a href="feedback.html">Feedback</a></li>
+
+
+
+
+
+ <p class="external">
+ <a href="#" id="collapseAll">Collapse All</a> | <a href="#" id="expandAll">Expand All</a>
+ </p>
+
+</ul>
+
+<!-- this highlights the active parent class in the sidebar. this is critical so that the parent expands when you're viewing a page. This must appear below the sidebar code above. Otherwise, if placed inside customscripts.js, the script runs before the sidebar code runs and the class never gets inserted.-->
+<script>$("li.active").parents('li').toggleClass("active");
+
+$(function() {
+ $("#dev-warning").hide();
+ changeSelectedDocVersionDropdownSelection($("#docVersion")[0]);
+ $("#docVersion").change(changeSelectedDocVersion);
+});
+
+function changeSelectedDocVersionDropdownSelection(element) {
+ var pathName = window.location.pathname;
+
+ var versionOptions = element.options;
+ for (var i = 0; i < versionOptions.length; i++) {
+ var versionValue = versionOptions[i].value;
+ if ((versionValue !== "") && pathName.startsWith("/ditto/"+versionValue+"/")) {
+ $("#docVersion").val(versionValue).change();
+ return;
+ }
+ }
+ // fallback: dev with "empty" version value:
+ $("#docVersion").val("").change();
+ $("#dev-warning").show();
+}
+function changeSelectedDocVersion() {
+ var versionValue = $('#docVersion').val();
+ var remainingPath = window.location.pathname.replace("/ditto/", "");
+ var versionMatch = remainingPath.match("([0-9].[0.9])/(.*)");
+ if (versionValue === "" && !versionMatch) {
+ // do nothing, we're already on the correct "dev" version
+ } else if (versionMatch && (versionValue === versionMatch[1])) {
+ // do nothing, we're already on the correct version
+ } else {
+ if (versionValue === "" && versionMatch) {
+ window.location.pathname = "ditto/" + versionMatch[2];
+ } else if (versionValue === "") {
+ window.location.pathname = "ditto/" + remainingPath;
+ } else if (versionMatch) {
+ window.location.pathname = "ditto/" + versionValue + "/" + versionMatch[2];
+ } else {
+ window.location.pathname = "ditto/" + versionValue + "/" + remainingPath;
+ }
+ }
+}
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Search protocol examples</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+
+
+
+<!-- this handles the automatic toc. use ## for subheads to auto-generate the on-page minitoc. if you use html tags, you must supply an ID for the heading element in order for it to appear in the minitoc. -->
+<script>
+$( document ).ready(function() {
+ // Handler for .ready() called.
+
+$('#toc').toc({ minimumHeaders: 0, listType: 'ul', showSpeed: 0, headers: 'h2,h3,h4' });
+
+/* this offset helps account for the space taken up by the floating toolbar. */
+$('#toc').on('click', 'a', function() {
+ var target = $(this.getAttribute('href'))
+ , scroll_target = target.offset().top
+
+ $(window).scrollTop(scroll_target - 10);
+ return false
+})
+
+});
+</script>
+
+<div id="toc"></div>
+
+
+
+
+
+
+
+
+
+
+<h2 id="createsubscription">CreateSubscription</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"_/_/things/twin/search/subscribe"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"444dae7e-bacf-312b-bc97-8f393dadf1bd"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"filter"</span><span class="p">:</span><span class="w"> </span><span class="s2">"eq(/attributes/temperature,32)"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"options"</span><span class="p">:</span><span class="w"> </span><span class="s2">"size(10),sort(+thingId)"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"namespaces"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
+ </span><span class="s2">"org.eclipse.ditto"</span><span class="w">
+ </span><span class="p">]</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"fields"</span><span class="p">:</span><span class="w"> </span><span class="s2">"attributes"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="requestfromsubscription">RequestFromSubscription</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"_/_/things/twin/search/request"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"subscriptionId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"24601"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"demand"</span><span class="p">:</span><span class="w"> </span><span class="mi">3</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="cancelsubscription">CancelSubscription</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"_/_/things/twin/search/cancel"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"subscriptionId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"24601"</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="subscriptioncreated">SubscriptionCreated</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"_/_/things/twin/search/created"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"444dae7e-bacf-312b-bc97-8f393dadf1bd"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"subscriptionId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"24601"</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="subscriptionnextpage">SubscriptionNextPage</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"_/_/things/twin/search/next"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"subscriptionId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"24601"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"items"</span><span class="p">:</span><span class="w"> </span><span class="p">[{</span><span class="w">
+ </span><span class="s2">"thingId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"default:thing1"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"attributes"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"temperature"</span><span class="p">:</span><span class="w"> </span><span class="mi">35</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"thingId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"default:thing2"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"attributes"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"temperature"</span><span class="p">:</span><span class="w"> </span><span class="mi">35</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">}]</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="subscriptioncomplete">SubscriptionComplete</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"_/_/things/twin/search/complete"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"subscriptionId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"24601"</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="subscriptionfailed">SubscriptionFailed</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"_/_/things/twin/search/failed"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/vnd.eclipse.ditto+json"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"subscriptionId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"24601"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"error"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">400</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"error"</span><span class="p">:</span><span class="w"> </span><span class="s2">"thing-search:subscription.protocol.error"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"message"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Rule 3.9: While the Subscription is not cancelled, Subscription.request(long n) MUST signal onError with a java.lang.IllegalArgumentException if the argument is <= 0. The cause message SHOULD explain that non-positive request signals are illegal."</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"description"</span><span class="p">:</span><span class="w"> </span><span class="s2">"The intent of this rule is to prevent faulty implementations to proceed operation without any exceptions being raised. Requesting a negative or 0 number of elements, since requests are additive, most likely to be the result of an erroneous calculation on the behalf of the Subscriber."</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+
+
+ <div class="tags">
+
+ </div>
+
+</div>
+
+<hr class="shaded"/>
+
+<footer>
+ <div class="row">
+ <div class="col-lg-12 footer">
+ <div class="logo">
+ <a href="https://eclipse.org"><img src="images/eclipse_foundation_logo.svg" alt="Eclipse logo"/></a>
+ </div>
+ <p class="notice">
+ ©2020 Eclipse Ditto.
+ Site last generated: Jul 1, 2020 <br />
+ </p>
+ <div class="quickLinks">
+ <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
+ > Privacy Policy
+ </a>
+ <a href="https://www.eclipse.org/legal/termsofuse.php" target="_blank">
+ > Terms of Use
+ </a>
+ <a href="https://www.eclipse.org/legal/copyright.php" target="_blank">
+ > Copyright Agent
+ </a>
+ <a href="https://www.eclipse.org/legal" target="_blank">
+ > Legal
+ </a>
+ <a href="https://www.eclipse.org/legal/epl-2.0/" target="_blank">
+ > License
+ </a>
+ <a href="https://eclipse.org/security" target="_blank">
+ > Report a Vulnerability
+ </a>
+ </div>
+ </div>
+ </div>
+</footer>
+
+
+ </div>
+ <!-- /.row -->
+</div>
+<!-- /.container -->
+</div>
+<!-- /#main -->
+ </div>
+
+</body>
+</html>
diff --git a/1.0/protocol-examples.html b/1.0/protocol-examples.html
index 194efd2..9529380 100644
--- a/1.0/protocol-examples.html
+++ b/1.0/protocol-examples.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1257,7 +1478,8 @@
<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
</span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/xdk_58/things/twin/commands/modify"</span><span class="p">,</span><span class="w">
</span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
- </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"a780b7b5-fdd2-4864-91fc-80df6bb0a636"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"a780b7b5-fdd2-4864-91fc-80df6bb0a636"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"requested-acks"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="s2">"twin-persisted"</span><span class="p">,</span><span class="s2">"custom-ack"</span><span class="w"> </span><span class="p">]</span><span class="w">
</span><span class="p">},</span><span class="w">
</span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/"</span><span class="w">
</span><span class="err">...</span><span class="w">
@@ -1288,7 +1510,8 @@
<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
</span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/thing_id_3141/things/twin/events/modified"</span><span class="p">,</span><span class="w">
</span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
- </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"a780b7b5-fdd2-4864-91fc-80df6bb0a636"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"a780b7b5-fdd2-4864-91fc-80df6bb0a636"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"requested-acks"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="s2">"custom-ack"</span><span class="w"> </span><span class="p">]</span><span class="w">
</span><span class="p">},</span><span class="w">
</span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/"</span><span class="p">,</span><span class="w">
</span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
@@ -1298,6 +1521,54 @@
</span><span class="p">}</span><span class="w">
</span></code></pre></div></div>
+<h2 id="acknowledgements-acks">Acknowledgements (ACKs)</h2>
+
+<p>A command issuer can require a response and specify the acknowledgements (ACKs) which have to be successfully fulfilled
+to regard the command as successfully executed.</p>
+
+<p>Below an example is given for a successfully fulfilled ACK (status 202):</p>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/thing_name_3141/things/twin/acks/custom-ack"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"a780b7b5-fdd2-4864-91fc-80df6bb0a636"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">202</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<p>And here is an example for a failed ACK (status 400):</p>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/thing_name_3141/things/twin/acks/custom-ack"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"a780b7b5-fdd2-4864-91fc-80df6bb0a636"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="s2">"You better try harder"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">400</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<p>An ACK representing a timeout would look like this:</p>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/thing_name_3141/things/twin/acks/custom-ack"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"a780b7b5-fdd2-4864-91fc-80df6bb0a636"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">408</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"error"</span><span class="p">:</span><span class="w"> </span><span class="s2">"acknowledgement:request.timeout"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"message"</span><span class="p">:</span><span class="w"> </span><span class="s2">"The acknowledgement request reached the specified timeout of 1,337ms."</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"description"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Try increasing the timeout and make sure that the requested acknowledgement is sent back in time."</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">408</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
<div class="tags">
@@ -1323,7 +1594,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-overview.html b/1.0/protocol-overview.html
index acf81f8..56fe214 100644
--- a/1.0/protocol-overview.html
+++ b/1.0/protocol-overview.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1289,7 +1510,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-specification-acks.html b/1.0/protocol-specification-acks.html
new file mode 100644
index 0000000..9b1e3c0
--- /dev/null
+++ b/1.0/protocol-specification-acks.html
@@ -0,0 +1,1573 @@
+<!DOCTYPE html>
+<html>
+<head>
+ <meta charset="utf-8">
+<meta http-equiv="X-UA-Compatible" content="IE=edge">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="description" content="">
+<meta name="keywords" content="protocol, protocol, specification, general">
+<title> Protocol specification for acknowledgements • Eclipse Ditto • a digital twin framework</title>
+
+<link rel="stylesheet" href="css/syntax.css">
+<link rel="stylesheet" type="text/css" href="//cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/modern-business.css">
+<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/customstyles.css">
+<link rel="stylesheet" href="css/boxshadowproperties.css">
+<link rel="stylesheet" href="css/theme-ditto.css">
+<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:400,700|Source+Code+Pro:300,600|Titillium+Web:400,600,700">
+
+<script src="//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.4/jquery.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/js/bootstrap.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/anchor-js/2.0.0/anchor.min.js" crossorigin="anonymous"></script>
+<script src="js/toc.js"></script>
+<script src="js/customscripts.js"></script>
+
+<script type="application/ld+json">
+{
+ "@context": "http://schema.org",
+ "@type": "Organization",
+ "url": "https://eclipse.org/ditto/",
+ "logo": "https://eclipse.org/ditto/images/ditto.svg"
+}
+</script>
+
+<link rel="icon" type="image/png" href="images/favicon-16x16.png" sizes="16x16">
+<link rel="icon" type="image/png" href="images/favicon-32x32.png" sizes="32x32">
+<link rel="icon" type="image/png" href="images/favicon-96x96.png" sizes="96x96">
+
+<link rel="alternate" type="application/rss+xml" title="Eclipse Ditto Blog" href="https://www.eclipse.org/ditto/feed.xml">
+
+<!-- Eclipse Foundation cookie consent: -->
+<link rel="stylesheet" type="text/css" href="//www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css" />
+<script src="//www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+ <script>
+ $(document).ready(function() {
+ $("#tg-sb-link").click(function() {
+ $("#tg-sb-sidebar").toggle();
+ $("#tg-sb-content").toggleClass('col-md-9');
+ $("#tg-sb-content").toggleClass('col-md-12');
+ $("#tg-sb-icon").toggleClass('fa-toggle-on');
+ $("#tg-sb-icon").toggleClass('fa-toggle-off');
+ });
+ });
+ </script>
+</head>
+
+
+<script>
+ (function(w,d,s,l,i){
+ w[l]=w[l]||[];
+ w[l].push({'gtm.start':
+ new Date().getTime(),event:'gtm.js'});
+ var f=d.getElementsByTagName(s)[0],
+ j=d.createElement(s),
+ dl=l!='dataLayer'?'&l='+l:'';
+ j.async=true;
+ j.src='https://www.googletagmanager.com/gtm.js?id='+i+dl;
+ f.parentNode.insertBefore(j,f);
+ })(window,document,'script','dataLayer','GTM-5WLCZXC');
+</script>
+
+
+
+<body>
+<!-- Navigation -->
+<nav class="navbar navbar-inverse navbar-fixed-top">
+ <div class="container topnavlinks">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-ditto-home" href="index.html"> <img src="images/ditto_allwhite_symbolonly.svg" class="ditto-navbar-symbol" alt="Home"> <img src="images/ditto_allwhite_textonly.svg" class="ditto-navbar-symbol-text" alt="Ditto"></a>
+ </div>
+ <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
+ <ul class="nav navbar-nav navbar-right">
+ <!-- toggle sidebar button -->
+ <!--<li><a id="tg-sb-link" href="#"><i id="tg-sb-icon" class="fa fa-toggle-on"></i> Nav</a></li>-->
+ <!-- entries without drop-downs appear here -->
+
+
+
+
+
+
+
+ <li><a href="blog.html">Blog</a></li>
+
+
+
+ <li><a href="intro-overview.html">Documentation</a></li>
+
+
+
+ <li><a href="http-api-doc.html">HTTP API</a></li>
+
+
+
+ <li><a href="https://ditto.eclipse.org" target="_blank">Sandbox</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">GitHub</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">GitHub examples</a></li>
+
+
+
+ <!-- entries with drop-downs appear here -->
+ <!-- conditional logic to control which topnav appears for the audience defined in the configuration file.-->
+
+
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Links<b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+
+ <li><a href="https://projects.eclipse.org/projects/iot.ditto" target="_blank">Eclipse Ditto Project</a></li>
+
+
+
+ <li><a href="https://www.eclipse.org/forums/index.php/f/364/" target="_blank">Forum</a></li>
+
+
+
+ <li><a href="https://ci.eclipse.org/ditto/" target="_blank">Jenkins</a></li>
+
+
+
+ <li><a href="https://dev.eclipse.org/mhonarc/lists/ditto-dev/" target="_blank">Mailing list archives</a></li>
+
+
+
+ <li><a href="https://gitter.im/eclipse/ditto" target="_blank">Gitter.im chat</a></li>
+
+
+ </ul>
+ </li>
+
+
+
+ <!--comment out this block if you want to hide search-->
+ <li>
+ <!--start search-->
+ <div id="search-demo-container">
+ <input type="text" id="search-input" placeholder="search...">
+ <ul id="results-container"></ul>
+ </div>
+ <script src="//cdnjs.cloudflare.com/ajax/libs/simple-jekyll-search/0.0.9/jekyll-search.js" type="text/javascript"></script>
+ <script type="text/javascript">
+ SimpleJekyllSearch.init({
+ searchInput: document.getElementById('search-input'),
+ resultsContainer: document.getElementById('results-container'),
+ dataSource: 'search.json',
+ searchResultTemplate: '<li><a href="{url}" title="Protocol specification for acknowledgements">{title}</a></li>',
+ noResultsText: 'No results found.',
+ limit: 10,
+ fuzzy: true,
+ })
+ </script>
+ <!--end search-->
+ </li>
+ </ul>
+ </div>
+ </div>
+ <!-- /.container -->
+</nav>
+
+<!-- Page Content -->
+<div class="container">
+ <div id="main">
+ <!-- Content Row -->
+ <div class="row">
+
+
+ <!-- Sidebar Column -->
+ <div class="col-md-3" id="tg-sb-sidebar">
+
+
+<ul id="mysidebar" class="nav">
+ <li class="sidebarTitle">
+ <label for="docVersion">Eclipse Ditto version:</label>
+ <div class="select-wrapper">
+ <select id="docVersion" name="docVersion">
+
+ <option value="">development</option>
+
+ <option value="1.0">1.0</option>
+
+ <option value="1.1">1.1</option>
+
+ </select>
+ </div>
+ <div id="dev-warning">
+ <div markdown="span" class="alert alert-warning" role="alert" style="font-size:0.6em"><i class="fa fa-warning"></i> <b>Important:</b> This documentation reflects the latest 'development'. You might want to choose a released version.</div>
+ </div>
+ </li>
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Introduction</a>
+ <ul>
+
+
+
+ <li><a href="intro-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="intro-digitaltwins.html">Digital twins</a></li>
+
+
+
+
+
+
+ <li><a href="intro-hello-world.html">Hello world</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Release Notes</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_100.html">1.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_090.html">0.9.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_080.html">0.8.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Milestone releases</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_100-M2.html">1.0.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_100-M1a.html">1.0.0-M1a</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M2.html">0.9.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M1.html">0.9.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M3.html">0.8.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M2.html">0.8.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M1.html">0.8.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M2.html">0.3.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M1.html">0.3.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_020-M1.html">0.2.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M3.html">0.1.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M1.html">0.1.0-M1</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Installation</a>
+ <ul>
+
+
+
+ <li><a href="installation-building.html">Building Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-running.html">Running Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-operating.html">Operating Ditto</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Basic concepts</a>
+ <ul>
+
+
+
+ <li><a href="basic-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Model entities</a>
+ <ul>
+
+
+
+ <li><a href="basic-thing.html">Thing</a></li>
+
+
+
+
+
+ <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
+
+
+
+
+
+ <li><a href="basic-feature.html">Feature</a></li>
+
+
+
+
+
+ <li><a href="basic-policy.html">Policy</a></li>
+
+
+
+
+
+ <li><a href="basic-namespaces-and-names.html">Namespaces and Names</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-auth.html">Authentication and Authorization</a></li>
+
+
+
+
+
+
+ <li><a href="basic-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="basic-signals.html">Signals</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Signal types</a>
+ <ul>
+
+
+
+ <li><a href="basic-signals-command.html">Command</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-commandresponse.html">Command response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-errorresponse.html">Error response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-event.html">Event</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-apis.html">APIs</a></li>
+
+
+
+
+
+
+ <li><a href="basic-connections.html">Connections</a></li>
+
+
+
+
+
+
+ <li><a href="basic-placeholders.html">Placeholders</a></li>
+
+
+
+
+
+
+ <li><a href="basic-changenotifications.html">Change notifications</a></li>
+
+
+
+
+
+
+ <li><a href="basic-rql.html">RQL expressions</a></li>
+
+
+
+
+
+
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
+ <li><a href="basic-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Architecture</a>
+ <ul>
+
+
+
+ <li><a href="architecture-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Services</a>
+ <ul>
+
+
+
+ <li><a href="architecture-services-policies.html">Policies</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things.html">Things</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things-search.html">Things-Search</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-connectivity.html">Connectivity</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-concierge.html">Concierge</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-gateway.html">Gateway</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>HTTP API</a>
+ <ul>
+
+
+
+ <li><a href="httpapi-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-concepts.html">Concepts</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-protocol-bindings-websocket.html">WebSocket protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-sse.html">Server sent events</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Connectivity API</a>
+ <ul>
+
+
+
+ <li><a href="connectivity-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-manage-connections.html">Manage connections</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp091.html">AMQP 0.9.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp10.html">AMQP 1.0 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-kafka2.html">Kafka 2.x protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-mapping.html">Payload mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-header-mapping.html">Header mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-tls-certificates.html">TLS certificates</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Client SDK</a>
+ <ul>
+
+
+
+ <li><a href="client-sdk-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-java.html">Java</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-javascript.html">JavaScript</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Ditto Protocol</a>
+ <ul>
+
+
+
+ <li><a href="protocol-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-twinlive.html">Twin/live channel</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification.html">Specification</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-topic.html">Protocol topic</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-things.html">Things group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-delete.html">Delete</a></li>
+
+
+
+
+
+ <li class="active"><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ search/messages</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-search.html">Search</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-messages.html">Messages</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-bindings.html">Bindings</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-examples.html">Examples</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-creatething.html">Create a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletething.html">Delete a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifything.html">Modify a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievething.html">Retrieve a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethings.html">Retrieve multiple Things</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattributes.html">Delete Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattributes.html">Modify Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattributes.html">Retrieve Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattribute.html">Create a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattribute.html">Delete a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattribute.html">Modify a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattribute.html">Retrieve a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createthingdefinition.html">Create a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletethingdefinition.html">Delete a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifythingdefinition.html">Modify a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethingdefinition.html">Retrieve a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeatures.html">Create Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeatures.html">Delete Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeatures.html">Modify Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeatures.html">Retrieve Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeature.html">Create a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeature.html">Delete a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeature.html">Modify a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeature.html">Retrieve a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdefinition.html">Create Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedefinition.html">Delete Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydefinition.html">Modify Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedefinition.html">Retrieve Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperties.html">Create Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperties.html">Delete Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperties.html">Modify Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperties.html">Retrieve Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperty.html">Create a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperty.html">Delete a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperty.html">Modify a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperty.html">Retrieve a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li><a href="sandbox.html">Sandbox</a></li>
+
+
+
+
+
+ <li><a href="presentations.html">Presentations</a></li>
+
+
+
+
+
+ <li><a href="glossary.html">Glossary</a></li>
+
+
+
+
+
+ <li><a href="feedback.html">Feedback</a></li>
+
+
+
+
+
+ <p class="external">
+ <a href="#" id="collapseAll">Collapse All</a> | <a href="#" id="expandAll">Expand All</a>
+ </p>
+
+</ul>
+
+<!-- this highlights the active parent class in the sidebar. this is critical so that the parent expands when you're viewing a page. This must appear below the sidebar code above. Otherwise, if placed inside customscripts.js, the script runs before the sidebar code runs and the class never gets inserted.-->
+<script>$("li.active").parents('li').toggleClass("active");
+
+$(function() {
+ $("#dev-warning").hide();
+ changeSelectedDocVersionDropdownSelection($("#docVersion")[0]);
+ $("#docVersion").change(changeSelectedDocVersion);
+});
+
+function changeSelectedDocVersionDropdownSelection(element) {
+ var pathName = window.location.pathname;
+
+ var versionOptions = element.options;
+ for (var i = 0; i < versionOptions.length; i++) {
+ var versionValue = versionOptions[i].value;
+ if ((versionValue !== "") && pathName.startsWith("/ditto/"+versionValue+"/")) {
+ $("#docVersion").val(versionValue).change();
+ return;
+ }
+ }
+ // fallback: dev with "empty" version value:
+ $("#docVersion").val("").change();
+ $("#dev-warning").show();
+}
+function changeSelectedDocVersion() {
+ var versionValue = $('#docVersion').val();
+ var remainingPath = window.location.pathname.replace("/ditto/", "");
+ var versionMatch = remainingPath.match("([0-9].[0.9])/(.*)");
+ if (versionValue === "" && !versionMatch) {
+ // do nothing, we're already on the correct "dev" version
+ } else if (versionMatch && (versionValue === versionMatch[1])) {
+ // do nothing, we're already on the correct version
+ } else {
+ if (versionValue === "" && versionMatch) {
+ window.location.pathname = "ditto/" + versionMatch[2];
+ } else if (versionValue === "") {
+ window.location.pathname = "ditto/" + remainingPath;
+ } else if (versionMatch) {
+ window.location.pathname = "ditto/" + versionValue + "/" + versionMatch[2];
+ } else {
+ window.location.pathname = "ditto/" + versionValue + "/" + remainingPath;
+ }
+ }
+}
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Protocol specification for acknowledgements</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+
+
+
+<!-- this handles the automatic toc. use ## for subheads to auto-generate the on-page minitoc. if you use html tags, you must supply an ID for the heading element in order for it to appear in the minitoc. -->
+<script>
+$( document ).ready(function() {
+ // Handler for .ready() called.
+
+$('#toc').toc({ minimumHeaders: 0, listType: 'ul', showSpeed: 0, headers: 'h2,h3,h4' });
+
+/* this offset helps account for the space taken up by the floating toolbar. */
+$('#toc').on('click', 'a', function() {
+ var target = $(this.getAttribute('href'))
+ , scroll_target = target.offset().top
+
+ $(window).scrollTop(scroll_target - 10);
+ return false
+})
+
+});
+</script>
+
+<div id="toc"></div>
+
+
+
+
+
+
+
+
+
+ <p>Ditto Protocol messages of <a href="basic-acknowledgements.html">acknowledgements</a> come in 2 different
+<a href="protocol-specification-topic.html">protocol topic</a> variants.</p>
+
+<h2 id="acknowledgement">Acknowledgement</h2>
+
+<p>An acknowledgment addressing a specific <a href="basic-acknowledgements.html#acknowledgement-labels">acknowledgement label</a>
+contains that label as last part of the topic:</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code><namespace>/<thingName>/things/<channel>/acks/<ack-label>
+</code></pre></div></div>
+
+<p>The Ditto Protocol representation of an <code class="highlighter-rouge">Acknowledgement</code> is specified as follows:</p>
+
+<script src="docson/widget.js" data-schema="../jsonschema/protocol-ack.json"></script>
+
+<h2 id="acknowledgements-aggregating">Acknowledgements (aggregating)</h2>
+
+<p>An acknowledgment for aggregated structures contains several single acknowledgements as
+its payload, and the topic is without a label:</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code><namespace>/<thingName>/things/<channel>/acks
+</code></pre></div></div>
+
+<p>The Ditto Protocol representation of <code class="highlighter-rouge">Acknowledgements</code> is specified as follows:</p>
+
+<script src="docson/widget.js" data-schema="../jsonschema/protocol-acks.json"></script>
+
+<h3 id="combined-status-code">Combined status code</h3>
+
+<p>The status code of the aggregating acknowledgements is derived based on the status codes of the contained single acks.</p>
+
+<ul>
+ <li>if only one acknowledgement is included, this acknowledgment’s status code is used</li>
+ <li>if several acknowledgements are included:
+ <ul>
+ <li>if all contained acknowledgements are successful (<code class="highlighter-rouge">200>=</code> HTTP status <code class="highlighter-rouge"><=299</code>), the overall status code is <code class="highlighter-rouge">200</code> (OK)</li>
+ <li>if at least one acknowledgement failed (HTTP status <code class="highlighter-rouge">>299</code>), the overall status code is <code class="highlighter-rouge">424</code> (Dependency failed)</li>
+ </ul>
+ </li>
+</ul>
+
+
+
+ <div class="tags">
+
+ <b>Tags: </b>
+
+
+
+ <a href="tag_protocol.html" class="btn btn-default navbar-btn cursorNorm" role="button">protocol</a>
+
+
+
+ </div>
+
+</div>
+
+<hr class="shaded"/>
+
+<footer>
+ <div class="row">
+ <div class="col-lg-12 footer">
+ <div class="logo">
+ <a href="https://eclipse.org"><img src="images/eclipse_foundation_logo.svg" alt="Eclipse logo"/></a>
+ </div>
+ <p class="notice">
+ ©2020 Eclipse Ditto.
+ Site last generated: Jul 1, 2020 <br />
+ </p>
+ <div class="quickLinks">
+ <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
+ > Privacy Policy
+ </a>
+ <a href="https://www.eclipse.org/legal/termsofuse.php" target="_blank">
+ > Terms of Use
+ </a>
+ <a href="https://www.eclipse.org/legal/copyright.php" target="_blank">
+ > Copyright Agent
+ </a>
+ <a href="https://www.eclipse.org/legal" target="_blank">
+ > Legal
+ </a>
+ <a href="https://www.eclipse.org/legal/epl-2.0/" target="_blank">
+ > License
+ </a>
+ <a href="https://eclipse.org/security" target="_blank">
+ > Report a Vulnerability
+ </a>
+ </div>
+ </div>
+ </div>
+</footer>
+
+
+ </div>
+ <!-- /.row -->
+</div>
+<!-- /.container -->
+</div>
+<!-- /#main -->
+ </div>
+
+</body>
+</html>
diff --git a/1.0/protocol-specification-policies-create-or-modify.html b/1.0/protocol-specification-policies-create-or-modify.html
new file mode 100644
index 0000000..b582a05
--- /dev/null
+++ b/1.0/protocol-specification-policies-create-or-modify.html
@@ -0,0 +1,2151 @@
+<!DOCTYPE html>
+<html>
+<head>
+ <meta charset="utf-8">
+<meta http-equiv="X-UA-Compatible" content="IE=edge">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="description" content="">
+<meta name="keywords" content="protocol, protocol, specification, create, modify, policy">
+<title> Policies - Create-Or-Modify protocol specification • Eclipse Ditto • a digital twin framework</title>
+
+<link rel="stylesheet" href="css/syntax.css">
+<link rel="stylesheet" type="text/css" href="//cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/modern-business.css">
+<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/customstyles.css">
+<link rel="stylesheet" href="css/boxshadowproperties.css">
+<link rel="stylesheet" href="css/theme-ditto.css">
+<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:400,700|Source+Code+Pro:300,600|Titillium+Web:400,600,700">
+
+<script src="//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.4/jquery.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/js/bootstrap.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/anchor-js/2.0.0/anchor.min.js" crossorigin="anonymous"></script>
+<script src="js/toc.js"></script>
+<script src="js/customscripts.js"></script>
+
+<script type="application/ld+json">
+{
+ "@context": "http://schema.org",
+ "@type": "Organization",
+ "url": "https://eclipse.org/ditto/",
+ "logo": "https://eclipse.org/ditto/images/ditto.svg"
+}
+</script>
+
+<link rel="icon" type="image/png" href="images/favicon-16x16.png" sizes="16x16">
+<link rel="icon" type="image/png" href="images/favicon-32x32.png" sizes="32x32">
+<link rel="icon" type="image/png" href="images/favicon-96x96.png" sizes="96x96">
+
+<link rel="alternate" type="application/rss+xml" title="Eclipse Ditto Blog" href="https://www.eclipse.org/ditto/feed.xml">
+
+<!-- Eclipse Foundation cookie consent: -->
+<link rel="stylesheet" type="text/css" href="//www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css" />
+<script src="//www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+ <script>
+ $(document).ready(function() {
+ $("#tg-sb-link").click(function() {
+ $("#tg-sb-sidebar").toggle();
+ $("#tg-sb-content").toggleClass('col-md-9');
+ $("#tg-sb-content").toggleClass('col-md-12');
+ $("#tg-sb-icon").toggleClass('fa-toggle-on');
+ $("#tg-sb-icon").toggleClass('fa-toggle-off');
+ });
+ });
+ </script>
+</head>
+
+
+<script>
+ (function(w,d,s,l,i){
+ w[l]=w[l]||[];
+ w[l].push({'gtm.start':
+ new Date().getTime(),event:'gtm.js'});
+ var f=d.getElementsByTagName(s)[0],
+ j=d.createElement(s),
+ dl=l!='dataLayer'?'&l='+l:'';
+ j.async=true;
+ j.src='https://www.googletagmanager.com/gtm.js?id='+i+dl;
+ f.parentNode.insertBefore(j,f);
+ })(window,document,'script','dataLayer','GTM-5WLCZXC');
+</script>
+
+
+
+<body>
+<!-- Navigation -->
+<nav class="navbar navbar-inverse navbar-fixed-top">
+ <div class="container topnavlinks">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-ditto-home" href="index.html"> <img src="images/ditto_allwhite_symbolonly.svg" class="ditto-navbar-symbol" alt="Home"> <img src="images/ditto_allwhite_textonly.svg" class="ditto-navbar-symbol-text" alt="Ditto"></a>
+ </div>
+ <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
+ <ul class="nav navbar-nav navbar-right">
+ <!-- toggle sidebar button -->
+ <!--<li><a id="tg-sb-link" href="#"><i id="tg-sb-icon" class="fa fa-toggle-on"></i> Nav</a></li>-->
+ <!-- entries without drop-downs appear here -->
+
+
+
+
+
+
+
+ <li><a href="blog.html">Blog</a></li>
+
+
+
+ <li><a href="intro-overview.html">Documentation</a></li>
+
+
+
+ <li><a href="http-api-doc.html">HTTP API</a></li>
+
+
+
+ <li><a href="https://ditto.eclipse.org" target="_blank">Sandbox</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">GitHub</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">GitHub examples</a></li>
+
+
+
+ <!-- entries with drop-downs appear here -->
+ <!-- conditional logic to control which topnav appears for the audience defined in the configuration file.-->
+
+
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Links<b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+
+ <li><a href="https://projects.eclipse.org/projects/iot.ditto" target="_blank">Eclipse Ditto Project</a></li>
+
+
+
+ <li><a href="https://www.eclipse.org/forums/index.php/f/364/" target="_blank">Forum</a></li>
+
+
+
+ <li><a href="https://ci.eclipse.org/ditto/" target="_blank">Jenkins</a></li>
+
+
+
+ <li><a href="https://dev.eclipse.org/mhonarc/lists/ditto-dev/" target="_blank">Mailing list archives</a></li>
+
+
+
+ <li><a href="https://gitter.im/eclipse/ditto" target="_blank">Gitter.im chat</a></li>
+
+
+ </ul>
+ </li>
+
+
+
+ <!--comment out this block if you want to hide search-->
+ <li>
+ <!--start search-->
+ <div id="search-demo-container">
+ <input type="text" id="search-input" placeholder="search...">
+ <ul id="results-container"></ul>
+ </div>
+ <script src="//cdnjs.cloudflare.com/ajax/libs/simple-jekyll-search/0.0.9/jekyll-search.js" type="text/javascript"></script>
+ <script type="text/javascript">
+ SimpleJekyllSearch.init({
+ searchInput: document.getElementById('search-input'),
+ resultsContainer: document.getElementById('results-container'),
+ dataSource: 'search.json',
+ searchResultTemplate: '<li><a href="{url}" title="Policies - Create-Or-Modify protocol specification">{title}</a></li>',
+ noResultsText: 'No results found.',
+ limit: 10,
+ fuzzy: true,
+ })
+ </script>
+ <!--end search-->
+ </li>
+ </ul>
+ </div>
+ </div>
+ <!-- /.container -->
+</nav>
+
+<!-- Page Content -->
+<div class="container">
+ <div id="main">
+ <!-- Content Row -->
+ <div class="row">
+
+
+ <!-- Sidebar Column -->
+ <div class="col-md-3" id="tg-sb-sidebar">
+
+
+<ul id="mysidebar" class="nav">
+ <li class="sidebarTitle">
+ <label for="docVersion">Eclipse Ditto version:</label>
+ <div class="select-wrapper">
+ <select id="docVersion" name="docVersion">
+
+ <option value="">development</option>
+
+ <option value="1.0">1.0</option>
+
+ <option value="1.1">1.1</option>
+
+ </select>
+ </div>
+ <div id="dev-warning">
+ <div markdown="span" class="alert alert-warning" role="alert" style="font-size:0.6em"><i class="fa fa-warning"></i> <b>Important:</b> This documentation reflects the latest 'development'. You might want to choose a released version.</div>
+ </div>
+ </li>
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Introduction</a>
+ <ul>
+
+
+
+ <li><a href="intro-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="intro-digitaltwins.html">Digital twins</a></li>
+
+
+
+
+
+
+ <li><a href="intro-hello-world.html">Hello world</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Release Notes</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_100.html">1.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_090.html">0.9.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_080.html">0.8.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Milestone releases</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_100-M2.html">1.0.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_100-M1a.html">1.0.0-M1a</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M2.html">0.9.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M1.html">0.9.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M3.html">0.8.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M2.html">0.8.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M1.html">0.8.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M2.html">0.3.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M1.html">0.3.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_020-M1.html">0.2.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M3.html">0.1.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M1.html">0.1.0-M1</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Installation</a>
+ <ul>
+
+
+
+ <li><a href="installation-building.html">Building Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-running.html">Running Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-operating.html">Operating Ditto</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Basic concepts</a>
+ <ul>
+
+
+
+ <li><a href="basic-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Model entities</a>
+ <ul>
+
+
+
+ <li><a href="basic-thing.html">Thing</a></li>
+
+
+
+
+
+ <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
+
+
+
+
+
+ <li><a href="basic-feature.html">Feature</a></li>
+
+
+
+
+
+ <li><a href="basic-policy.html">Policy</a></li>
+
+
+
+
+
+ <li><a href="basic-namespaces-and-names.html">Namespaces and Names</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-auth.html">Authentication and Authorization</a></li>
+
+
+
+
+
+
+ <li><a href="basic-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="basic-signals.html">Signals</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Signal types</a>
+ <ul>
+
+
+
+ <li><a href="basic-signals-command.html">Command</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-commandresponse.html">Command response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-errorresponse.html">Error response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-event.html">Event</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-apis.html">APIs</a></li>
+
+
+
+
+
+
+ <li><a href="basic-connections.html">Connections</a></li>
+
+
+
+
+
+
+ <li><a href="basic-placeholders.html">Placeholders</a></li>
+
+
+
+
+
+
+ <li><a href="basic-changenotifications.html">Change notifications</a></li>
+
+
+
+
+
+
+ <li><a href="basic-rql.html">RQL expressions</a></li>
+
+
+
+
+
+
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
+ <li><a href="basic-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Architecture</a>
+ <ul>
+
+
+
+ <li><a href="architecture-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Services</a>
+ <ul>
+
+
+
+ <li><a href="architecture-services-policies.html">Policies</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things.html">Things</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things-search.html">Things-Search</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-connectivity.html">Connectivity</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-concierge.html">Concierge</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-gateway.html">Gateway</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>HTTP API</a>
+ <ul>
+
+
+
+ <li><a href="httpapi-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-concepts.html">Concepts</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-protocol-bindings-websocket.html">WebSocket protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-sse.html">Server sent events</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Connectivity API</a>
+ <ul>
+
+
+
+ <li><a href="connectivity-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-manage-connections.html">Manage connections</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp091.html">AMQP 0.9.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp10.html">AMQP 1.0 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-kafka2.html">Kafka 2.x protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-mapping.html">Payload mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-header-mapping.html">Header mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-tls-certificates.html">TLS certificates</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Client SDK</a>
+ <ul>
+
+
+
+ <li><a href="client-sdk-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-java.html">Java</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-javascript.html">JavaScript</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Ditto Protocol</a>
+ <ul>
+
+
+
+ <li><a href="protocol-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-twinlive.html">Twin/live channel</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification.html">Specification</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-topic.html">Protocol topic</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-things.html">Things group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-delete.html">Delete</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ search/messages</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-search.html">Search</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-messages.html">Messages</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li class="active"><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-bindings.html">Bindings</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-examples.html">Examples</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-creatething.html">Create a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletething.html">Delete a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifything.html">Modify a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievething.html">Retrieve a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethings.html">Retrieve multiple Things</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattributes.html">Delete Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattributes.html">Modify Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattributes.html">Retrieve Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattribute.html">Create a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattribute.html">Delete a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattribute.html">Modify a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattribute.html">Retrieve a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createthingdefinition.html">Create a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletethingdefinition.html">Delete a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifythingdefinition.html">Modify a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethingdefinition.html">Retrieve a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeatures.html">Create Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeatures.html">Delete Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeatures.html">Modify Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeatures.html">Retrieve Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeature.html">Create a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeature.html">Delete a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeature.html">Modify a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeature.html">Retrieve a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdefinition.html">Create Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedefinition.html">Delete Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydefinition.html">Modify Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedefinition.html">Retrieve Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperties.html">Create Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperties.html">Delete Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperties.html">Modify Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperties.html">Retrieve Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperty.html">Create a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperty.html">Delete a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperty.html">Modify a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperty.html">Retrieve a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li><a href="sandbox.html">Sandbox</a></li>
+
+
+
+
+
+ <li><a href="presentations.html">Presentations</a></li>
+
+
+
+
+
+ <li><a href="glossary.html">Glossary</a></li>
+
+
+
+
+
+ <li><a href="feedback.html">Feedback</a></li>
+
+
+
+
+
+ <p class="external">
+ <a href="#" id="collapseAll">Collapse All</a> | <a href="#" id="expandAll">Expand All</a>
+ </p>
+
+</ul>
+
+<!-- this highlights the active parent class in the sidebar. this is critical so that the parent expands when you're viewing a page. This must appear below the sidebar code above. Otherwise, if placed inside customscripts.js, the script runs before the sidebar code runs and the class never gets inserted.-->
+<script>$("li.active").parents('li').toggleClass("active");
+
+$(function() {
+ $("#dev-warning").hide();
+ changeSelectedDocVersionDropdownSelection($("#docVersion")[0]);
+ $("#docVersion").change(changeSelectedDocVersion);
+});
+
+function changeSelectedDocVersionDropdownSelection(element) {
+ var pathName = window.location.pathname;
+
+ var versionOptions = element.options;
+ for (var i = 0; i < versionOptions.length; i++) {
+ var versionValue = versionOptions[i].value;
+ if ((versionValue !== "") && pathName.startsWith("/ditto/"+versionValue+"/")) {
+ $("#docVersion").val(versionValue).change();
+ return;
+ }
+ }
+ // fallback: dev with "empty" version value:
+ $("#docVersion").val("").change();
+ $("#dev-warning").show();
+}
+function changeSelectedDocVersion() {
+ var versionValue = $('#docVersion').val();
+ var remainingPath = window.location.pathname.replace("/ditto/", "");
+ var versionMatch = remainingPath.match("([0-9].[0.9])/(.*)");
+ if (versionValue === "" && !versionMatch) {
+ // do nothing, we're already on the correct "dev" version
+ } else if (versionMatch && (versionValue === versionMatch[1])) {
+ // do nothing, we're already on the correct version
+ } else {
+ if (versionValue === "" && versionMatch) {
+ window.location.pathname = "ditto/" + versionMatch[2];
+ } else if (versionValue === "") {
+ window.location.pathname = "ditto/" + remainingPath;
+ } else if (versionMatch) {
+ window.location.pathname = "ditto/" + versionValue + "/" + versionMatch[2];
+ } else {
+ window.location.pathname = "ditto/" + versionValue + "/" + remainingPath;
+ }
+ }
+}
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Policies - Create-Or-Modify protocol specification</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+
+
+
+<!-- this handles the automatic toc. use ## for subheads to auto-generate the on-page minitoc. if you use html tags, you must supply an ID for the heading element in order for it to appear in the minitoc. -->
+<script>
+$( document ).ready(function() {
+ // Handler for .ready() called.
+
+$('#toc').toc({ minimumHeaders: 0, listType: 'ul', showSpeed: 0, headers: 'h2,h3,h4' });
+
+/* this offset helps account for the space taken up by the floating toolbar. */
+$('#toc').on('click', 'a', function() {
+ var target = $(this.getAttribute('href'))
+ , scroll_target = target.offset().top
+
+ $(window).scrollTop(scroll_target - 10);
+ return false
+})
+
+});
+</script>
+
+<div id="toc"></div>
+
+
+
+
+
+
+
+
+
+ <h2 id="create-a-policy">Create a Policy</h2>
+
+<p>Create a Policy with the ID specified by the <code class="highlighter-rouge"><namespace>/<policyName></code> pair in the topic and the
+ JSON representation provided in the <code class="highlighter-rouge">value</code>.</p>
+
+<h3 id="command">Command</h3>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge"><namespace>/<policyName>/policies/commands/create</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>The complete Policy as JSON object, see <a href="protocol-specification-policies.html#policy-representation">Policy representation (JSON)</a>.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="response">Response</h3>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th> </th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge"><namespace>/<policyName>/policies/commands/create</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td> </td>
+ <td>The created Policy as JSON object, see <a href="protocol-specification-policies.html#policy-representation">Policy representation (JSON)</a>.</td>
+ </tr>
+ <tr>
+ <td><strong>status</strong></td>
+ <td><em>code</em></td>
+ <td> </td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td><code class="highlighter-rouge">201</code></td>
+ <td>Success - The Policy was successfully created.</td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong> <a href="protocol-examples-policies-createpolicy.html">Create a Policy</a>.</p>
+
+<h2 id="create-or-modify-a-policy">Create or modify a Policy</h2>
+
+<p>This command modifies the Policy with the ID specified by the <code class="highlighter-rouge"><namespace>/<policyName></code> pair in the <code class="highlighter-rouge">topic</code> and with the
+ JSON provided in the <code class="highlighter-rouge">value</code>, if it already exists. Otherwise, the Policy is created.</p>
+
+<h3 id="command-1">Command</h3>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge"><namespace>/<policyName>/policies/commands/modify</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>The complete Policy as JSON.<br />see <a href="protocol-specification-policies.html#policy-representation">Policy representation (JSON)</a></td>
+ </tr>
+ </tbody>
+</table>
+
+<p>For modifying an existing policy, the authorized subject needs WRITE permission on the <code class="highlighter-rouge">policy:/.</code> resource.<br />
+If the Policy does not yet exist, the same rules apply as described for the <a href="#create-a-policy">create command</a>.</p>
+
+<h3 id="response-1">Response</h3>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th> </th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge"><namespace>/<policyName>/policies/commands/modify</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td> </td>
+ <td>The created Policy as JSON object, see <a href="protocol-specification-policies.html#policy-representation">Policy representation (JSON)</a>. This field is not available, if the Policy entry already existed.</td>
+ </tr>
+ <tr>
+ <td><strong>status</strong></td>
+ <td><em>code</em></td>
+ <td> </td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td><code class="highlighter-rouge">201</code></td>
+ <td>Success - The Policy was successfully created.</td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td><code class="highlighter-rouge">204</code></td>
+ <td>Success - The Policy was successfully updated.</td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong> <a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></p>
+
+<h2 id="modify-policy-entries">Modify Policy entries</h2>
+
+<p>Modify the Policy entries of the Policy identified by the <code class="highlighter-rouge"><namespace>/<policyName></code> pair in the <code class="highlighter-rouge">topic</code> field.</p>
+
+<h3 id="command-2">Command</h3>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge"><namespace>/<policyName>/policies/commands/modify</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/entries</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>The Policy entries as JSON.<br />see <a href="protocol-specification-policies.html#policy-representation">Policy representation (JSON)</a></td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="response-2">Response</h3>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th> </th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge"><namespace>/<policyName>/policies/commands/modify</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/entries</code></td>
+ </tr>
+ <tr>
+ <td><strong>status</strong></td>
+ <td><em>code</em></td>
+ <td> </td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td><code class="highlighter-rouge">204</code></td>
+ <td>Success - The Policy entries were successfully updated.</td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong> <a href="protocol-examples-policies-modifypolicyentries.html">Modify all Policy entries</a></p>
+
+<h2 id="create-or-modify-a-policy-entry">Create or modify a Policy entry</h2>
+
+<p>Create or modify the Policy entry identified by the <code class="highlighter-rouge"><namespace>/<policyName></code> pair in the <code class="highlighter-rouge">topic</code> field and the <code class="highlighter-rouge"><label></code> in
+ the <code class="highlighter-rouge">path</code> field.
+<br />
+If you specify a new label, the respective Policy entry will be created. <br />
+If you specify an existing label, the respective Policy entry will be updated.</p>
+
+<h3 id="command-3">Command</h3>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge"><namespace>/<policyName>/policies/commands/modify</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/entries/<label></code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>The Policy entry as JSON.<br />see <a href="protocol-specification-policies.html#policy-representation">Policy representation (JSON)</a></td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="response-3">Response</h3>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th> </th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge"><namespace>/<policyName>/policies/commands/modify</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/entries/<label></code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td> </td>
+ <td>The created Policy entry as JSON object, see <a href="protocol-specification-policies.html#policy-representation">Policy representation (JSON)</a>. This field is not available, if the Policy entry already existed.</td>
+ </tr>
+ <tr>
+ <td><strong>status</strong></td>
+ <td><em>code</em></td>
+ <td> </td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td><code class="highlighter-rouge">201</code></td>
+ <td>Success - The Policy entry was successfully created.</td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td><code class="highlighter-rouge">204</code></td>
+ <td>Success - The Policy entry was successfully updated.</td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong> <a href="protocol-examples-policies-modifypolicyentry.html">Modify a single Policy entry</a></p>
+
+<h2 id="modify-all-subjects">Modify all subjects</h2>
+
+<p>Modify at once all subjects of the Policy entry identified by the <code class="highlighter-rouge"><namespace>/<policyName></code> pair in the <code class="highlighter-rouge">topic</code>
+field and by the <code class="highlighter-rouge"><label></code> in the <code class="highlighter-rouge">path</code> topic.</p>
+
+<h3 id="command-4">Command</h3>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge"><namespace>/<policyName>/policies/commands/modify</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/entries/<label>/subjects</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>The subjects of the policy as JSON.<br />see <a href="protocol-specification-policies.html#policy-representation">Policy representation (JSON)</a></td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="response-4">Response</h3>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th> </th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge"><namespace>/<policyName>/policies/commands/modify</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/entries/<label>/subjects</code></td>
+ </tr>
+ <tr>
+ <td><strong>status</strong></td>
+ <td><em>code</em></td>
+ <td> </td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td><code class="highlighter-rouge">204</code></td>
+ <td>Success - The subjects of the policy were successfully updated.</td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong> <a href="protocol-examples-policies-modifysubjects.html">Modify all subjects</a></p>
+
+<h2 id="create-or-modify-a-single-subject">Create or modify a single subject</h2>
+
+<p>Create or modify the subject with ID <code class="highlighter-rouge">subjectId</code> of the Policy identified by the <code class="highlighter-rouge"><namespace>/<policyName></code> pair in the
+ <code class="highlighter-rouge">topic</code> field and by the <code class="highlighter-rouge"><label></code> and the <code class="highlighter-rouge"><subjectId></code> in the <code class="highlighter-rouge">path</code> field.</p>
+
+<h3 id="command-5">Command</h3>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge"><namespace>/<policyName>/policies/commands/modify</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/entries/<label>/subjects/<subjectId></code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>The subject of the policy as JSON.<br />see <a href="protocol-specification-policies.html#policy-representation">Policy representation (JSON)</a></td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="response-5">Response</h3>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th> </th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge"><namespace>/<policyName>/policies/commands/modify</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/entries/<label>/subjects/<subjectId></code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td> </td>
+ <td>The created subject as JSON object, see <a href="protocol-specification-policies.html#policy-representation">Policy representation (JSON)</a>. This field is not available, if the subject already existed.</td>
+ </tr>
+ <tr>
+ <td><strong>status</strong></td>
+ <td><em>code</em></td>
+ <td> </td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td><code class="highlighter-rouge">201</code></td>
+ <td>Success - The subject was successfully created.</td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td><code class="highlighter-rouge">204</code></td>
+ <td>Success - The subject was successfully updated.</td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong> <a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></p>
+
+<h2 id="modify-all-resources">Modify all resources</h2>
+
+<p>Modify all resources of the Policy identified by the <code class="highlighter-rouge"><namespace>/<policyName></code> pair in the <code class="highlighter-rouge">topic</code> field and by the <code class="highlighter-rouge"><label></code> in the <code class="highlighter-rouge">path</code> field.</p>
+
+<h3 id="command-6">Command</h3>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge"><namespace>/<policyName>/policies/commands/modify</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/entries/<label>/resources</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>The resources of the policy as JSON.<br />see <a href="protocol-specification-policies.html#policy-representation">Policy representation (JSON)</a></td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="response-6">Response</h3>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th> </th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge"><namespace>/<policyName>/policies/commands/modify</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/entries/<label>/resources</code></td>
+ </tr>
+ <tr>
+ <td><strong>status</strong></td>
+ <td><em>code</em></td>
+ <td> </td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td><code class="highlighter-rouge">204</code></td>
+ <td>Success - The Policy resources were successfully updated.</td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong> <a href="protocol-examples-policies-modifyresources.html">Modify all resources</a></p>
+
+<h2 id="create-or-modify-a-single-resource">Create or modify a single resource</h2>
+
+<p>Create or modify the resource identified by the <code class="highlighter-rouge">path</code> field of the Policy entry identified the
+<code class="highlighter-rouge"><namespace>/<policyName></code> pair in the <code class="highlighter-rouge">topic</code> field and the <code class="highlighter-rouge"><resource></code> in the <code class="highlighter-rouge">path</code> field.</p>
+
+<h3 id="command-7">Command</h3>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge"><namespace>/<policyName>/policies/commands/modify</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/entries/<label>/resources/<resource></code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>The Policy resource as JSON.<br />see <a href="protocol-specification-policies.html#policy-representation">Policy representation (JSON)</a></td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="response-7">Response</h3>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th> </th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge"><namespace>/<policyName>/policies/commands/modify</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/entries/<label>/resources/<resource></code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td> </td>
+ <td>The created Policy resource as JSON object, see <a href="protocol-specification-policies.html#policy-representation">Policy representation (JSON)</a>. This field is not available, if the resource already existed.</td>
+ </tr>
+ <tr>
+ <td><strong>status</strong></td>
+ <td><em>code</em></td>
+ <td> </td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td><code class="highlighter-rouge">201</code></td>
+ <td>Success - The resource was successfully created.</td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td><code class="highlighter-rouge">204</code></td>
+ <td>Success - The resource was successfully updated.</td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong> <a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></p>
+
+<h2 id="common-errors">Common errors</h2>
+
+<table>
+ <thead>
+ <tr>
+ <th><strong>status</strong></th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><code class="highlighter-rouge">400</code></td>
+ <td>Bad Format - The request could not be completed due to malformed request syntax.</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">401</code></td>
+ <td>Unauthorized - The request could not be completed due to missing authentication.</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">403</code></td>
+ <td>Forbidden - The Policy could not be modified as the requester had insufficient permissions (‘WRITE’ is required).</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">404</code></td>
+ <td>Not Found - The request could not be completed. The Policy with the given ID was not found in the context of the authenticated user.</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">412</code></td>
+ <td>Precondition Failed - A precondition for reading or writing the (sub-)resource failed. This will happen for write requests, if you specified an If-Match or If-None-Match header, which fails the precondition check against the current ETag of the (sub-)resource.</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">413</code></td>
+ <td>Request Entity Too Large - The created or modified entity is larger than the accepted limit of 100 kB.</td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td>See <a href="protocol-examples-policies-errorresponses">Policy Error Responses</a> for examples of other error responses.</td>
+ </tr>
+ </tbody>
+</table>
+
+
+ <div class="tags">
+
+ <b>Tags: </b>
+
+
+
+ <a href="tag_protocol.html" class="btn btn-default navbar-btn cursorNorm" role="button">protocol</a>
+
+
+
+ </div>
+
+</div>
+
+<hr class="shaded"/>
+
+<footer>
+ <div class="row">
+ <div class="col-lg-12 footer">
+ <div class="logo">
+ <a href="https://eclipse.org"><img src="images/eclipse_foundation_logo.svg" alt="Eclipse logo"/></a>
+ </div>
+ <p class="notice">
+ ©2020 Eclipse Ditto.
+ Site last generated: Jul 1, 2020 <br />
+ </p>
+ <div class="quickLinks">
+ <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
+ > Privacy Policy
+ </a>
+ <a href="https://www.eclipse.org/legal/termsofuse.php" target="_blank">
+ > Terms of Use
+ </a>
+ <a href="https://www.eclipse.org/legal/copyright.php" target="_blank">
+ > Copyright Agent
+ </a>
+ <a href="https://www.eclipse.org/legal" target="_blank">
+ > Legal
+ </a>
+ <a href="https://www.eclipse.org/legal/epl-2.0/" target="_blank">
+ > License
+ </a>
+ <a href="https://eclipse.org/security" target="_blank">
+ > Report a Vulnerability
+ </a>
+ </div>
+ </div>
+ </div>
+</footer>
+
+
+ </div>
+ <!-- /.row -->
+</div>
+<!-- /.container -->
+</div>
+<!-- /#main -->
+ </div>
+
+</body>
+</html>
diff --git a/1.0/protocol-specification-policies-delete.html b/1.0/protocol-specification-policies-delete.html
new file mode 100644
index 0000000..9c39fdf
--- /dev/null
+++ b/1.0/protocol-specification-policies-delete.html
@@ -0,0 +1,1821 @@
+<!DOCTYPE html>
+<html>
+<head>
+ <meta charset="utf-8">
+<meta http-equiv="X-UA-Compatible" content="IE=edge">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="description" content="">
+<meta name="keywords" content="protocol, protocol, specification, delete, policy">
+<title> Policies - Delete protocol specification • Eclipse Ditto • a digital twin framework</title>
+
+<link rel="stylesheet" href="css/syntax.css">
+<link rel="stylesheet" type="text/css" href="//cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/modern-business.css">
+<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/customstyles.css">
+<link rel="stylesheet" href="css/boxshadowproperties.css">
+<link rel="stylesheet" href="css/theme-ditto.css">
+<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:400,700|Source+Code+Pro:300,600|Titillium+Web:400,600,700">
+
+<script src="//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.4/jquery.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/js/bootstrap.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/anchor-js/2.0.0/anchor.min.js" crossorigin="anonymous"></script>
+<script src="js/toc.js"></script>
+<script src="js/customscripts.js"></script>
+
+<script type="application/ld+json">
+{
+ "@context": "http://schema.org",
+ "@type": "Organization",
+ "url": "https://eclipse.org/ditto/",
+ "logo": "https://eclipse.org/ditto/images/ditto.svg"
+}
+</script>
+
+<link rel="icon" type="image/png" href="images/favicon-16x16.png" sizes="16x16">
+<link rel="icon" type="image/png" href="images/favicon-32x32.png" sizes="32x32">
+<link rel="icon" type="image/png" href="images/favicon-96x96.png" sizes="96x96">
+
+<link rel="alternate" type="application/rss+xml" title="Eclipse Ditto Blog" href="https://www.eclipse.org/ditto/feed.xml">
+
+<!-- Eclipse Foundation cookie consent: -->
+<link rel="stylesheet" type="text/css" href="//www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css" />
+<script src="//www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+ <script>
+ $(document).ready(function() {
+ $("#tg-sb-link").click(function() {
+ $("#tg-sb-sidebar").toggle();
+ $("#tg-sb-content").toggleClass('col-md-9');
+ $("#tg-sb-content").toggleClass('col-md-12');
+ $("#tg-sb-icon").toggleClass('fa-toggle-on');
+ $("#tg-sb-icon").toggleClass('fa-toggle-off');
+ });
+ });
+ </script>
+</head>
+
+
+<script>
+ (function(w,d,s,l,i){
+ w[l]=w[l]||[];
+ w[l].push({'gtm.start':
+ new Date().getTime(),event:'gtm.js'});
+ var f=d.getElementsByTagName(s)[0],
+ j=d.createElement(s),
+ dl=l!='dataLayer'?'&l='+l:'';
+ j.async=true;
+ j.src='https://www.googletagmanager.com/gtm.js?id='+i+dl;
+ f.parentNode.insertBefore(j,f);
+ })(window,document,'script','dataLayer','GTM-5WLCZXC');
+</script>
+
+
+
+<body>
+<!-- Navigation -->
+<nav class="navbar navbar-inverse navbar-fixed-top">
+ <div class="container topnavlinks">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-ditto-home" href="index.html"> <img src="images/ditto_allwhite_symbolonly.svg" class="ditto-navbar-symbol" alt="Home"> <img src="images/ditto_allwhite_textonly.svg" class="ditto-navbar-symbol-text" alt="Ditto"></a>
+ </div>
+ <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
+ <ul class="nav navbar-nav navbar-right">
+ <!-- toggle sidebar button -->
+ <!--<li><a id="tg-sb-link" href="#"><i id="tg-sb-icon" class="fa fa-toggle-on"></i> Nav</a></li>-->
+ <!-- entries without drop-downs appear here -->
+
+
+
+
+
+
+
+ <li><a href="blog.html">Blog</a></li>
+
+
+
+ <li><a href="intro-overview.html">Documentation</a></li>
+
+
+
+ <li><a href="http-api-doc.html">HTTP API</a></li>
+
+
+
+ <li><a href="https://ditto.eclipse.org" target="_blank">Sandbox</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">GitHub</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">GitHub examples</a></li>
+
+
+
+ <!-- entries with drop-downs appear here -->
+ <!-- conditional logic to control which topnav appears for the audience defined in the configuration file.-->
+
+
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Links<b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+
+ <li><a href="https://projects.eclipse.org/projects/iot.ditto" target="_blank">Eclipse Ditto Project</a></li>
+
+
+
+ <li><a href="https://www.eclipse.org/forums/index.php/f/364/" target="_blank">Forum</a></li>
+
+
+
+ <li><a href="https://ci.eclipse.org/ditto/" target="_blank">Jenkins</a></li>
+
+
+
+ <li><a href="https://dev.eclipse.org/mhonarc/lists/ditto-dev/" target="_blank">Mailing list archives</a></li>
+
+
+
+ <li><a href="https://gitter.im/eclipse/ditto" target="_blank">Gitter.im chat</a></li>
+
+
+ </ul>
+ </li>
+
+
+
+ <!--comment out this block if you want to hide search-->
+ <li>
+ <!--start search-->
+ <div id="search-demo-container">
+ <input type="text" id="search-input" placeholder="search...">
+ <ul id="results-container"></ul>
+ </div>
+ <script src="//cdnjs.cloudflare.com/ajax/libs/simple-jekyll-search/0.0.9/jekyll-search.js" type="text/javascript"></script>
+ <script type="text/javascript">
+ SimpleJekyllSearch.init({
+ searchInput: document.getElementById('search-input'),
+ resultsContainer: document.getElementById('results-container'),
+ dataSource: 'search.json',
+ searchResultTemplate: '<li><a href="{url}" title="Policies - Delete protocol specification">{title}</a></li>',
+ noResultsText: 'No results found.',
+ limit: 10,
+ fuzzy: true,
+ })
+ </script>
+ <!--end search-->
+ </li>
+ </ul>
+ </div>
+ </div>
+ <!-- /.container -->
+</nav>
+
+<!-- Page Content -->
+<div class="container">
+ <div id="main">
+ <!-- Content Row -->
+ <div class="row">
+
+
+ <!-- Sidebar Column -->
+ <div class="col-md-3" id="tg-sb-sidebar">
+
+
+<ul id="mysidebar" class="nav">
+ <li class="sidebarTitle">
+ <label for="docVersion">Eclipse Ditto version:</label>
+ <div class="select-wrapper">
+ <select id="docVersion" name="docVersion">
+
+ <option value="">development</option>
+
+ <option value="1.0">1.0</option>
+
+ <option value="1.1">1.1</option>
+
+ </select>
+ </div>
+ <div id="dev-warning">
+ <div markdown="span" class="alert alert-warning" role="alert" style="font-size:0.6em"><i class="fa fa-warning"></i> <b>Important:</b> This documentation reflects the latest 'development'. You might want to choose a released version.</div>
+ </div>
+ </li>
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Introduction</a>
+ <ul>
+
+
+
+ <li><a href="intro-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="intro-digitaltwins.html">Digital twins</a></li>
+
+
+
+
+
+
+ <li><a href="intro-hello-world.html">Hello world</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Release Notes</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_100.html">1.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_090.html">0.9.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_080.html">0.8.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Milestone releases</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_100-M2.html">1.0.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_100-M1a.html">1.0.0-M1a</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M2.html">0.9.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M1.html">0.9.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M3.html">0.8.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M2.html">0.8.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M1.html">0.8.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M2.html">0.3.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M1.html">0.3.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_020-M1.html">0.2.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M3.html">0.1.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M1.html">0.1.0-M1</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Installation</a>
+ <ul>
+
+
+
+ <li><a href="installation-building.html">Building Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-running.html">Running Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-operating.html">Operating Ditto</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Basic concepts</a>
+ <ul>
+
+
+
+ <li><a href="basic-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Model entities</a>
+ <ul>
+
+
+
+ <li><a href="basic-thing.html">Thing</a></li>
+
+
+
+
+
+ <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
+
+
+
+
+
+ <li><a href="basic-feature.html">Feature</a></li>
+
+
+
+
+
+ <li><a href="basic-policy.html">Policy</a></li>
+
+
+
+
+
+ <li><a href="basic-namespaces-and-names.html">Namespaces and Names</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-auth.html">Authentication and Authorization</a></li>
+
+
+
+
+
+
+ <li><a href="basic-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="basic-signals.html">Signals</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Signal types</a>
+ <ul>
+
+
+
+ <li><a href="basic-signals-command.html">Command</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-commandresponse.html">Command response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-errorresponse.html">Error response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-event.html">Event</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-apis.html">APIs</a></li>
+
+
+
+
+
+
+ <li><a href="basic-connections.html">Connections</a></li>
+
+
+
+
+
+
+ <li><a href="basic-placeholders.html">Placeholders</a></li>
+
+
+
+
+
+
+ <li><a href="basic-changenotifications.html">Change notifications</a></li>
+
+
+
+
+
+
+ <li><a href="basic-rql.html">RQL expressions</a></li>
+
+
+
+
+
+
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
+ <li><a href="basic-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Architecture</a>
+ <ul>
+
+
+
+ <li><a href="architecture-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Services</a>
+ <ul>
+
+
+
+ <li><a href="architecture-services-policies.html">Policies</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things.html">Things</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things-search.html">Things-Search</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-connectivity.html">Connectivity</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-concierge.html">Concierge</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-gateway.html">Gateway</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>HTTP API</a>
+ <ul>
+
+
+
+ <li><a href="httpapi-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-concepts.html">Concepts</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-protocol-bindings-websocket.html">WebSocket protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-sse.html">Server sent events</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Connectivity API</a>
+ <ul>
+
+
+
+ <li><a href="connectivity-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-manage-connections.html">Manage connections</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp091.html">AMQP 0.9.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp10.html">AMQP 1.0 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-kafka2.html">Kafka 2.x protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-mapping.html">Payload mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-header-mapping.html">Header mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-tls-certificates.html">TLS certificates</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Client SDK</a>
+ <ul>
+
+
+
+ <li><a href="client-sdk-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-java.html">Java</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-javascript.html">JavaScript</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Ditto Protocol</a>
+ <ul>
+
+
+
+ <li><a href="protocol-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-twinlive.html">Twin/live channel</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification.html">Specification</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-topic.html">Protocol topic</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-things.html">Things group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-delete.html">Delete</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ search/messages</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-search.html">Search</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-messages.html">Messages</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li class="active"><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-bindings.html">Bindings</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-examples.html">Examples</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-creatething.html">Create a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletething.html">Delete a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifything.html">Modify a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievething.html">Retrieve a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethings.html">Retrieve multiple Things</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattributes.html">Delete Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattributes.html">Modify Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattributes.html">Retrieve Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattribute.html">Create a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattribute.html">Delete a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattribute.html">Modify a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattribute.html">Retrieve a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createthingdefinition.html">Create a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletethingdefinition.html">Delete a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifythingdefinition.html">Modify a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethingdefinition.html">Retrieve a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeatures.html">Create Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeatures.html">Delete Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeatures.html">Modify Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeatures.html">Retrieve Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeature.html">Create a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeature.html">Delete a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeature.html">Modify a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeature.html">Retrieve a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdefinition.html">Create Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedefinition.html">Delete Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydefinition.html">Modify Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedefinition.html">Retrieve Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperties.html">Create Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperties.html">Delete Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperties.html">Modify Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperties.html">Retrieve Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperty.html">Create a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperty.html">Delete a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperty.html">Modify a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperty.html">Retrieve a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li><a href="sandbox.html">Sandbox</a></li>
+
+
+
+
+
+ <li><a href="presentations.html">Presentations</a></li>
+
+
+
+
+
+ <li><a href="glossary.html">Glossary</a></li>
+
+
+
+
+
+ <li><a href="feedback.html">Feedback</a></li>
+
+
+
+
+
+ <p class="external">
+ <a href="#" id="collapseAll">Collapse All</a> | <a href="#" id="expandAll">Expand All</a>
+ </p>
+
+</ul>
+
+<!-- this highlights the active parent class in the sidebar. this is critical so that the parent expands when you're viewing a page. This must appear below the sidebar code above. Otherwise, if placed inside customscripts.js, the script runs before the sidebar code runs and the class never gets inserted.-->
+<script>$("li.active").parents('li').toggleClass("active");
+
+$(function() {
+ $("#dev-warning").hide();
+ changeSelectedDocVersionDropdownSelection($("#docVersion")[0]);
+ $("#docVersion").change(changeSelectedDocVersion);
+});
+
+function changeSelectedDocVersionDropdownSelection(element) {
+ var pathName = window.location.pathname;
+
+ var versionOptions = element.options;
+ for (var i = 0; i < versionOptions.length; i++) {
+ var versionValue = versionOptions[i].value;
+ if ((versionValue !== "") && pathName.startsWith("/ditto/"+versionValue+"/")) {
+ $("#docVersion").val(versionValue).change();
+ return;
+ }
+ }
+ // fallback: dev with "empty" version value:
+ $("#docVersion").val("").change();
+ $("#dev-warning").show();
+}
+function changeSelectedDocVersion() {
+ var versionValue = $('#docVersion').val();
+ var remainingPath = window.location.pathname.replace("/ditto/", "");
+ var versionMatch = remainingPath.match("([0-9].[0.9])/(.*)");
+ if (versionValue === "" && !versionMatch) {
+ // do nothing, we're already on the correct "dev" version
+ } else if (versionMatch && (versionValue === versionMatch[1])) {
+ // do nothing, we're already on the correct version
+ } else {
+ if (versionValue === "" && versionMatch) {
+ window.location.pathname = "ditto/" + versionMatch[2];
+ } else if (versionValue === "") {
+ window.location.pathname = "ditto/" + remainingPath;
+ } else if (versionMatch) {
+ window.location.pathname = "ditto/" + versionValue + "/" + versionMatch[2];
+ } else {
+ window.location.pathname = "ditto/" + versionValue + "/" + remainingPath;
+ }
+ }
+}
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Policies - Delete protocol specification</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+
+
+
+<!-- this handles the automatic toc. use ## for subheads to auto-generate the on-page minitoc. if you use html tags, you must supply an ID for the heading element in order for it to appear in the minitoc. -->
+<script>
+$( document ).ready(function() {
+ // Handler for .ready() called.
+
+$('#toc').toc({ minimumHeaders: 0, listType: 'ul', showSpeed: 0, headers: 'h2,h3,h4' });
+
+/* this offset helps account for the space taken up by the floating toolbar. */
+$('#toc').on('click', 'a', function() {
+ var target = $(this.getAttribute('href'))
+ , scroll_target = target.offset().top
+
+ $(window).scrollTop(scroll_target - 10);
+ return false
+})
+
+});
+</script>
+
+<div id="toc"></div>
+
+
+
+
+
+
+
+
+
+ <h2 id="delete-a-policy">Delete a Policy</h2>
+
+<p>Delete the policy identified by the <code class="highlighter-rouge"><namespace>/<policyName></code> pair in the <code class="highlighter-rouge">topic</code> field.</p>
+
+<h3 id="command">Command</h3>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge"><namespace>/<policyName>/policies/commands/delete</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/</code></td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="response">Response</h3>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th> </th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge"><namespace>/<policyName>/policies/commands/delete</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/</code></td>
+ </tr>
+ <tr>
+ <td><strong>status</strong></td>
+ <td><em>code</em></td>
+ <td> </td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td><code class="highlighter-rouge">204</code></td>
+ <td>Success - The Policy was successfully deleted.</td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong> <a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></p>
+
+<h2 id="delete-a-policy-entry">Delete a Policy entry</h2>
+
+<p>Deletes a Policy entry identified by the <code class="highlighter-rouge"><namespace>/<policyName></code> pair in the <code class="highlighter-rouge">topic</code> field and the <code class="highlighter-rouge"><label></code> in the
+ <code class="highlighter-rouge">path</code> field.</p>
+
+<h3 id="command-1">Command</h3>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge"><namespace>/<policyName>/policies/commands/delete</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/entries/<label></code></td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="response-1">Response</h3>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th> </th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge"><namespace>/<policyName>/policies/commands/delete</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/entries/<label></code></td>
+ </tr>
+ <tr>
+ <td><strong>status</strong></td>
+ <td><em>code</em></td>
+ <td> </td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td><code class="highlighter-rouge">204</code></td>
+ <td>Success - The Policy entry was successfully deleted.</td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong> <a href="protocol-examples-policies-deletepolicyentry.html">Delete a Policy entry</a></p>
+
+<h2 id="delete-a-single-resource">Delete a single resource</h2>
+
+<p>Deletes the resource identified by the <code class="highlighter-rouge"><namespace>/<policyName></code> pair in the <code class="highlighter-rouge">topic</code> field and the <code class="highlighter-rouge"><label></code> and
+ <code class="highlighter-rouge"><resource></code> in the <code class="highlighter-rouge">path</code> field.</p>
+
+<h3 id="command-2">Command</h3>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge"><namespace>/<policyName>/policies/commands/delete</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/entries/<label>/resources/<resource></code></td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="response-2">Response</h3>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th> </th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge"><namespace>/<policyName>/policies/commands/delete</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/entries/<label>/resources/<resource></code></td>
+ </tr>
+ <tr>
+ <td><strong>status</strong></td>
+ <td><em>code</em></td>
+ <td> </td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td><code class="highlighter-rouge">204</code></td>
+ <td>Success - The resource was successfully deleted.</td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong> <a href="protocol-examples-policies-deleteresource.html">Delete a resource</a></p>
+
+<h2 id="delete-a-single-subject">Delete a single subject</h2>
+
+<p>Delete the subject identified by the <code class="highlighter-rouge"><namespace>/<policyName></code> pair in the <code class="highlighter-rouge">topic</code> field and the <code class="highlighter-rouge"><label></code> and
+ <code class="highlighter-rouge"><subjectId></code> in the <code class="highlighter-rouge">path</code> field.</p>
+
+<h3 id="command-3">Command</h3>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge"><namespace>/<policyName>/policies/commands/delete</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/entries/<label>/subjects/<subjectId></code></td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="response-3">Response</h3>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th> </th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge"><namespace>/<policyName>/policies/commands/delete</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/entries/<label>/subjects/<subjectId></code></td>
+ </tr>
+ <tr>
+ <td><strong>status</strong></td>
+ <td><em>code</em></td>
+ <td> </td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td><code class="highlighter-rouge">204</code></td>
+ <td>Success - The subject was successfully deleted.</td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong> <a href="protocol-examples-policies-deletesubject.html">Delete a subject</a></p>
+
+<h2 id="common-errors">Common errors</h2>
+
+<table>
+ <thead>
+ <tr>
+ <th><strong>status</strong></th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><code class="highlighter-rouge">400</code></td>
+ <td>Bad Format - The request could not be completed due to malformed request syntax.</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">401</code></td>
+ <td>Unauthorized - The request could not be completed due to missing authentication.</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">403</code></td>
+ <td>Forbidden - The Policy could not be modified as the requester had insufficient permissions (‘WRITE’ is required).</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">404</code></td>
+ <td>Not Found - The request could not be completed. The Policy with the given ID was not found in the context of the authenticated user.</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">412</code></td>
+ <td>Precondition Failed - A precondition for reading or writing the (sub-)resource failed. This will happen for write requests, if you specified an If-Match or If-None-Match header, which fails the precondition check against the current ETag of the (sub-)resource.</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">413</code></td>
+ <td>Request Entity Too Large - The created or modified entity is larger than the accepted limit of 100 kB.</td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td>See <a href="protocol-examples-policies-errorresponses.html">Policy Error Responses</a> for examples of other error responses.</td>
+ </tr>
+ </tbody>
+</table>
+
+
+ <div class="tags">
+
+ <b>Tags: </b>
+
+
+
+ <a href="tag_protocol.html" class="btn btn-default navbar-btn cursorNorm" role="button">protocol</a>
+
+
+
+ </div>
+
+</div>
+
+<hr class="shaded"/>
+
+<footer>
+ <div class="row">
+ <div class="col-lg-12 footer">
+ <div class="logo">
+ <a href="https://eclipse.org"><img src="images/eclipse_foundation_logo.svg" alt="Eclipse logo"/></a>
+ </div>
+ <p class="notice">
+ ©2020 Eclipse Ditto.
+ Site last generated: Jul 1, 2020 <br />
+ </p>
+ <div class="quickLinks">
+ <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
+ > Privacy Policy
+ </a>
+ <a href="https://www.eclipse.org/legal/termsofuse.php" target="_blank">
+ > Terms of Use
+ </a>
+ <a href="https://www.eclipse.org/legal/copyright.php" target="_blank">
+ > Copyright Agent
+ </a>
+ <a href="https://www.eclipse.org/legal" target="_blank">
+ > Legal
+ </a>
+ <a href="https://www.eclipse.org/legal/epl-2.0/" target="_blank">
+ > License
+ </a>
+ <a href="https://eclipse.org/security" target="_blank">
+ > Report a Vulnerability
+ </a>
+ </div>
+ </div>
+ </div>
+</footer>
+
+
+ </div>
+ <!-- /.row -->
+</div>
+<!-- /.container -->
+</div>
+<!-- /#main -->
+ </div>
+
+</body>
+</html>
diff --git a/1.0/protocol-specification-policies-retrieve.html b/1.0/protocol-specification-policies-retrieve.html
new file mode 100644
index 0000000..7ea46d8
--- /dev/null
+++ b/1.0/protocol-specification-policies-retrieve.html
@@ -0,0 +1,2044 @@
+<!DOCTYPE html>
+<html>
+<head>
+ <meta charset="utf-8">
+<meta http-equiv="X-UA-Compatible" content="IE=edge">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="description" content="">
+<meta name="keywords" content="protocol, protocol, specification, retrieve, policy">
+<title> Policies - Retrieve protocol specification • Eclipse Ditto • a digital twin framework</title>
+
+<link rel="stylesheet" href="css/syntax.css">
+<link rel="stylesheet" type="text/css" href="//cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/modern-business.css">
+<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/customstyles.css">
+<link rel="stylesheet" href="css/boxshadowproperties.css">
+<link rel="stylesheet" href="css/theme-ditto.css">
+<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:400,700|Source+Code+Pro:300,600|Titillium+Web:400,600,700">
+
+<script src="//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.4/jquery.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/js/bootstrap.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/anchor-js/2.0.0/anchor.min.js" crossorigin="anonymous"></script>
+<script src="js/toc.js"></script>
+<script src="js/customscripts.js"></script>
+
+<script type="application/ld+json">
+{
+ "@context": "http://schema.org",
+ "@type": "Organization",
+ "url": "https://eclipse.org/ditto/",
+ "logo": "https://eclipse.org/ditto/images/ditto.svg"
+}
+</script>
+
+<link rel="icon" type="image/png" href="images/favicon-16x16.png" sizes="16x16">
+<link rel="icon" type="image/png" href="images/favicon-32x32.png" sizes="32x32">
+<link rel="icon" type="image/png" href="images/favicon-96x96.png" sizes="96x96">
+
+<link rel="alternate" type="application/rss+xml" title="Eclipse Ditto Blog" href="https://www.eclipse.org/ditto/feed.xml">
+
+<!-- Eclipse Foundation cookie consent: -->
+<link rel="stylesheet" type="text/css" href="//www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css" />
+<script src="//www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+ <script>
+ $(document).ready(function() {
+ $("#tg-sb-link").click(function() {
+ $("#tg-sb-sidebar").toggle();
+ $("#tg-sb-content").toggleClass('col-md-9');
+ $("#tg-sb-content").toggleClass('col-md-12');
+ $("#tg-sb-icon").toggleClass('fa-toggle-on');
+ $("#tg-sb-icon").toggleClass('fa-toggle-off');
+ });
+ });
+ </script>
+</head>
+
+
+<script>
+ (function(w,d,s,l,i){
+ w[l]=w[l]||[];
+ w[l].push({'gtm.start':
+ new Date().getTime(),event:'gtm.js'});
+ var f=d.getElementsByTagName(s)[0],
+ j=d.createElement(s),
+ dl=l!='dataLayer'?'&l='+l:'';
+ j.async=true;
+ j.src='https://www.googletagmanager.com/gtm.js?id='+i+dl;
+ f.parentNode.insertBefore(j,f);
+ })(window,document,'script','dataLayer','GTM-5WLCZXC');
+</script>
+
+
+
+<body>
+<!-- Navigation -->
+<nav class="navbar navbar-inverse navbar-fixed-top">
+ <div class="container topnavlinks">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-ditto-home" href="index.html"> <img src="images/ditto_allwhite_symbolonly.svg" class="ditto-navbar-symbol" alt="Home"> <img src="images/ditto_allwhite_textonly.svg" class="ditto-navbar-symbol-text" alt="Ditto"></a>
+ </div>
+ <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
+ <ul class="nav navbar-nav navbar-right">
+ <!-- toggle sidebar button -->
+ <!--<li><a id="tg-sb-link" href="#"><i id="tg-sb-icon" class="fa fa-toggle-on"></i> Nav</a></li>-->
+ <!-- entries without drop-downs appear here -->
+
+
+
+
+
+
+
+ <li><a href="blog.html">Blog</a></li>
+
+
+
+ <li><a href="intro-overview.html">Documentation</a></li>
+
+
+
+ <li><a href="http-api-doc.html">HTTP API</a></li>
+
+
+
+ <li><a href="https://ditto.eclipse.org" target="_blank">Sandbox</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">GitHub</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">GitHub examples</a></li>
+
+
+
+ <!-- entries with drop-downs appear here -->
+ <!-- conditional logic to control which topnav appears for the audience defined in the configuration file.-->
+
+
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Links<b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+
+ <li><a href="https://projects.eclipse.org/projects/iot.ditto" target="_blank">Eclipse Ditto Project</a></li>
+
+
+
+ <li><a href="https://www.eclipse.org/forums/index.php/f/364/" target="_blank">Forum</a></li>
+
+
+
+ <li><a href="https://ci.eclipse.org/ditto/" target="_blank">Jenkins</a></li>
+
+
+
+ <li><a href="https://dev.eclipse.org/mhonarc/lists/ditto-dev/" target="_blank">Mailing list archives</a></li>
+
+
+
+ <li><a href="https://gitter.im/eclipse/ditto" target="_blank">Gitter.im chat</a></li>
+
+
+ </ul>
+ </li>
+
+
+
+ <!--comment out this block if you want to hide search-->
+ <li>
+ <!--start search-->
+ <div id="search-demo-container">
+ <input type="text" id="search-input" placeholder="search...">
+ <ul id="results-container"></ul>
+ </div>
+ <script src="//cdnjs.cloudflare.com/ajax/libs/simple-jekyll-search/0.0.9/jekyll-search.js" type="text/javascript"></script>
+ <script type="text/javascript">
+ SimpleJekyllSearch.init({
+ searchInput: document.getElementById('search-input'),
+ resultsContainer: document.getElementById('results-container'),
+ dataSource: 'search.json',
+ searchResultTemplate: '<li><a href="{url}" title="Policies - Retrieve protocol specification">{title}</a></li>',
+ noResultsText: 'No results found.',
+ limit: 10,
+ fuzzy: true,
+ })
+ </script>
+ <!--end search-->
+ </li>
+ </ul>
+ </div>
+ </div>
+ <!-- /.container -->
+</nav>
+
+<!-- Page Content -->
+<div class="container">
+ <div id="main">
+ <!-- Content Row -->
+ <div class="row">
+
+
+ <!-- Sidebar Column -->
+ <div class="col-md-3" id="tg-sb-sidebar">
+
+
+<ul id="mysidebar" class="nav">
+ <li class="sidebarTitle">
+ <label for="docVersion">Eclipse Ditto version:</label>
+ <div class="select-wrapper">
+ <select id="docVersion" name="docVersion">
+
+ <option value="">development</option>
+
+ <option value="1.0">1.0</option>
+
+ <option value="1.1">1.1</option>
+
+ </select>
+ </div>
+ <div id="dev-warning">
+ <div markdown="span" class="alert alert-warning" role="alert" style="font-size:0.6em"><i class="fa fa-warning"></i> <b>Important:</b> This documentation reflects the latest 'development'. You might want to choose a released version.</div>
+ </div>
+ </li>
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Introduction</a>
+ <ul>
+
+
+
+ <li><a href="intro-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="intro-digitaltwins.html">Digital twins</a></li>
+
+
+
+
+
+
+ <li><a href="intro-hello-world.html">Hello world</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Release Notes</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_100.html">1.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_090.html">0.9.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_080.html">0.8.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Milestone releases</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_100-M2.html">1.0.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_100-M1a.html">1.0.0-M1a</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M2.html">0.9.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M1.html">0.9.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M3.html">0.8.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M2.html">0.8.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M1.html">0.8.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M2.html">0.3.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M1.html">0.3.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_020-M1.html">0.2.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M3.html">0.1.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M1.html">0.1.0-M1</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Installation</a>
+ <ul>
+
+
+
+ <li><a href="installation-building.html">Building Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-running.html">Running Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-operating.html">Operating Ditto</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Basic concepts</a>
+ <ul>
+
+
+
+ <li><a href="basic-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Model entities</a>
+ <ul>
+
+
+
+ <li><a href="basic-thing.html">Thing</a></li>
+
+
+
+
+
+ <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
+
+
+
+
+
+ <li><a href="basic-feature.html">Feature</a></li>
+
+
+
+
+
+ <li><a href="basic-policy.html">Policy</a></li>
+
+
+
+
+
+ <li><a href="basic-namespaces-and-names.html">Namespaces and Names</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-auth.html">Authentication and Authorization</a></li>
+
+
+
+
+
+
+ <li><a href="basic-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="basic-signals.html">Signals</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Signal types</a>
+ <ul>
+
+
+
+ <li><a href="basic-signals-command.html">Command</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-commandresponse.html">Command response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-errorresponse.html">Error response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-event.html">Event</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-apis.html">APIs</a></li>
+
+
+
+
+
+
+ <li><a href="basic-connections.html">Connections</a></li>
+
+
+
+
+
+
+ <li><a href="basic-placeholders.html">Placeholders</a></li>
+
+
+
+
+
+
+ <li><a href="basic-changenotifications.html">Change notifications</a></li>
+
+
+
+
+
+
+ <li><a href="basic-rql.html">RQL expressions</a></li>
+
+
+
+
+
+
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
+ <li><a href="basic-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Architecture</a>
+ <ul>
+
+
+
+ <li><a href="architecture-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Services</a>
+ <ul>
+
+
+
+ <li><a href="architecture-services-policies.html">Policies</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things.html">Things</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things-search.html">Things-Search</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-connectivity.html">Connectivity</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-concierge.html">Concierge</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-gateway.html">Gateway</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>HTTP API</a>
+ <ul>
+
+
+
+ <li><a href="httpapi-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-concepts.html">Concepts</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-protocol-bindings-websocket.html">WebSocket protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-sse.html">Server sent events</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Connectivity API</a>
+ <ul>
+
+
+
+ <li><a href="connectivity-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-manage-connections.html">Manage connections</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp091.html">AMQP 0.9.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp10.html">AMQP 1.0 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-kafka2.html">Kafka 2.x protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-mapping.html">Payload mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-header-mapping.html">Header mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-tls-certificates.html">TLS certificates</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Client SDK</a>
+ <ul>
+
+
+
+ <li><a href="client-sdk-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-java.html">Java</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-javascript.html">JavaScript</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Ditto Protocol</a>
+ <ul>
+
+
+
+ <li><a href="protocol-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-twinlive.html">Twin/live channel</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification.html">Specification</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-topic.html">Protocol topic</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-things.html">Things group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-delete.html">Delete</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ search/messages</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-search.html">Search</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-messages.html">Messages</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li class="active"><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-bindings.html">Bindings</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-examples.html">Examples</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-creatething.html">Create a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletething.html">Delete a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifything.html">Modify a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievething.html">Retrieve a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethings.html">Retrieve multiple Things</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattributes.html">Delete Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattributes.html">Modify Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattributes.html">Retrieve Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattribute.html">Create a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattribute.html">Delete a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattribute.html">Modify a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattribute.html">Retrieve a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createthingdefinition.html">Create a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletethingdefinition.html">Delete a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifythingdefinition.html">Modify a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethingdefinition.html">Retrieve a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeatures.html">Create Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeatures.html">Delete Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeatures.html">Modify Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeatures.html">Retrieve Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeature.html">Create a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeature.html">Delete a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeature.html">Modify a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeature.html">Retrieve a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdefinition.html">Create Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedefinition.html">Delete Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydefinition.html">Modify Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedefinition.html">Retrieve Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperties.html">Create Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperties.html">Delete Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperties.html">Modify Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperties.html">Retrieve Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperty.html">Create a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperty.html">Delete a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperty.html">Modify a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperty.html">Retrieve a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li><a href="sandbox.html">Sandbox</a></li>
+
+
+
+
+
+ <li><a href="presentations.html">Presentations</a></li>
+
+
+
+
+
+ <li><a href="glossary.html">Glossary</a></li>
+
+
+
+
+
+ <li><a href="feedback.html">Feedback</a></li>
+
+
+
+
+
+ <p class="external">
+ <a href="#" id="collapseAll">Collapse All</a> | <a href="#" id="expandAll">Expand All</a>
+ </p>
+
+</ul>
+
+<!-- this highlights the active parent class in the sidebar. this is critical so that the parent expands when you're viewing a page. This must appear below the sidebar code above. Otherwise, if placed inside customscripts.js, the script runs before the sidebar code runs and the class never gets inserted.-->
+<script>$("li.active").parents('li').toggleClass("active");
+
+$(function() {
+ $("#dev-warning").hide();
+ changeSelectedDocVersionDropdownSelection($("#docVersion")[0]);
+ $("#docVersion").change(changeSelectedDocVersion);
+});
+
+function changeSelectedDocVersionDropdownSelection(element) {
+ var pathName = window.location.pathname;
+
+ var versionOptions = element.options;
+ for (var i = 0; i < versionOptions.length; i++) {
+ var versionValue = versionOptions[i].value;
+ if ((versionValue !== "") && pathName.startsWith("/ditto/"+versionValue+"/")) {
+ $("#docVersion").val(versionValue).change();
+ return;
+ }
+ }
+ // fallback: dev with "empty" version value:
+ $("#docVersion").val("").change();
+ $("#dev-warning").show();
+}
+function changeSelectedDocVersion() {
+ var versionValue = $('#docVersion').val();
+ var remainingPath = window.location.pathname.replace("/ditto/", "");
+ var versionMatch = remainingPath.match("([0-9].[0.9])/(.*)");
+ if (versionValue === "" && !versionMatch) {
+ // do nothing, we're already on the correct "dev" version
+ } else if (versionMatch && (versionValue === versionMatch[1])) {
+ // do nothing, we're already on the correct version
+ } else {
+ if (versionValue === "" && versionMatch) {
+ window.location.pathname = "ditto/" + versionMatch[2];
+ } else if (versionValue === "") {
+ window.location.pathname = "ditto/" + remainingPath;
+ } else if (versionMatch) {
+ window.location.pathname = "ditto/" + versionValue + "/" + versionMatch[2];
+ } else {
+ window.location.pathname = "ditto/" + versionValue + "/" + remainingPath;
+ }
+ }
+}
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Policies - Retrieve protocol specification</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+
+
+
+<!-- this handles the automatic toc. use ## for subheads to auto-generate the on-page minitoc. if you use html tags, you must supply an ID for the heading element in order for it to appear in the minitoc. -->
+<script>
+$( document ).ready(function() {
+ // Handler for .ready() called.
+
+$('#toc').toc({ minimumHeaders: 0, listType: 'ul', showSpeed: 0, headers: 'h2,h3,h4' });
+
+/* this offset helps account for the space taken up by the floating toolbar. */
+$('#toc').on('click', 'a', function() {
+ var target = $(this.getAttribute('href'))
+ , scroll_target = target.offset().top
+
+ $(window).scrollTop(scroll_target - 10);
+ return false
+})
+
+});
+</script>
+
+<div id="toc"></div>
+
+
+
+
+
+
+
+
+
+ <div class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> The <em>topic path</em> of policy commands contains no <em>channel</em> element.
+See the <a href="protocol-specification-policies.html#ditto-protocol-topic-structure-for-policies">specification</a> for details. </div>
+
+<h2 id="retrieve-a-policy">Retrieve a Policy</h2>
+
+<p>Retrieves a Policy identified by the <code class="highlighter-rouge"><namespace>/<policyName></code> pair in the <code class="highlighter-rouge">topic</code> field.</p>
+
+<h3 id="command">Command</h3>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge"><namespace>/<policyName>/policies/commands/retrieve</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/</code></td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="response">Response</h3>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th> </th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge"><namespace>/<policyName>/policies/commands/retrieve</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td> </td>
+ <td>The Policy as JSON object, see <a href="protocol-specification-policies.html#policy-representation">Policy representation (JSON)</a>.</td>
+ </tr>
+ <tr>
+ <td><strong>status</strong></td>
+ <td><em>code</em></td>
+ <td> </td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td><code class="highlighter-rouge">200</code></td>
+ <td>Success.</td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong> <a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></p>
+
+<h2 id="retrieve-policy-entries">Retrieve Policy entries</h2>
+
+<p>Retrieves all entries of the policy identified by the <code class="highlighter-rouge"><namespace>/<policyName></code> pair in the <code class="highlighter-rouge">topic</code> field.</p>
+
+<h3 id="command-1">Command</h3>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge"><namespace>/<policyName>/policies/commands/retrieve</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/entries</code></td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="response-1">Response</h3>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th> </th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge"><namespace>/<policyName>/policies/commands/retrieve</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/entries</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td> </td>
+ <td>The Policy entries as JSON object, see <a href="protocol-specification-policies.html#policy-representation">Policy representation (JSON)</a>.</td>
+ </tr>
+ <tr>
+ <td><strong>status</strong></td>
+ <td><em>code</em></td>
+ <td> </td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td><code class="highlighter-rouge">200</code></td>
+ <td>Success.</td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong> <a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve all Policy entries</a></p>
+
+<h2 id="retrieve-a-policy-entry">Retrieve a Policy entry</h2>
+
+<p>Retrieve a Policy entry identified by the <code class="highlighter-rouge"><namespace>/<policyName></code> pair in the <code class="highlighter-rouge">topic</code> field
+and the <code class="highlighter-rouge"><label></code> in the <code class="highlighter-rouge">path</code> field.</p>
+
+<h3 id="command-2">Command</h3>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge"><namespace>/<policyName>/policies/commands/retrieve</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/entries/<label></code></td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="response-2">Response</h3>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th> </th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge"><namespace>/<policyName>/policies/commands/retrieve</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/entries/<label></code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td> </td>
+ <td>The Policy entry as JSON object, see <a href="protocol-specification-policies.html#policy-representation">Policy representation (JSON)</a>.</td>
+ </tr>
+ <tr>
+ <td><strong>status</strong></td>
+ <td><em>code</em></td>
+ <td> </td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td><code class="highlighter-rouge">200</code></td>
+ <td>Success.</td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong> <a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single Policy entry</a></p>
+
+<h2 id="retrieve-policy-subjects">Retrieve Policy subjects</h2>
+
+<p>Retrieve the subjects of the policy identified by the <code class="highlighter-rouge"><namespace>/<policyName></code> pair in the <code class="highlighter-rouge">topic</code> field
+and the <code class="highlighter-rouge"><label></code> in the <code class="highlighter-rouge">path</code> field.</p>
+
+<h3 id="command-3">Command</h3>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge"><namespace>/<policyName>/policies/commands/retrieve</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/entries/<label>/subjects</code></td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="response-3">Response</h3>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th> </th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge"><namespace>/<policyName>/policies/commands/retrieve</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/entries/<label>/subjects</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td> </td>
+ <td>The subjects of the Policy as JSON object, see <a href="protocol-specification-policies.html#policy-representation">Policy representation (JSON)</a>.</td>
+ </tr>
+ <tr>
+ <td><strong>status</strong></td>
+ <td><em>code</em></td>
+ <td> </td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td><code class="highlighter-rouge">200</code></td>
+ <td>Success.</td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong> <a href="protocol-examples-policies-retrievesubjects.html">Retrieve all subjects</a></p>
+
+<h2 id="retrieve-a-policy-subject">Retrieve a Policy subject</h2>
+
+<p>Retrieve specific subject of the policy identified by the <code class="highlighter-rouge"><namespace>/<policyName></code> pair in the <code class="highlighter-rouge">topic</code> field
+and the <code class="highlighter-rouge"><label></code> and <code class="highlighter-rouge"><subjectId></code> in the <code class="highlighter-rouge">path</code> field.</p>
+
+<h3 id="command-4">Command</h3>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge"><namespace>/<policyName>/policies/commands/retrieve</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/entries/<label>/subjects/<subjectId></code></td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="response-4">Response</h3>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th> </th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge"><namespace>/<policyName>/policies/commands/retrieve</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/entries/<label>/subjects/<subjectId></code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td> </td>
+ <td>The subject of the policy as JSON object, see <a href="protocol-specification-policies.html#policy-representation">Policy representation (JSON)</a>.</td>
+ </tr>
+ <tr>
+ <td><strong>status</strong></td>
+ <td><em>code</em></td>
+ <td> </td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td><code class="highlighter-rouge">200</code></td>
+ <td>Success.</td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong> <a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></p>
+
+<h2 id="retrieve-policy-resources">Retrieve Policy resources</h2>
+
+<p>Retrieve all resources of the policy identified by the <code class="highlighter-rouge"><namespace>/<policyName></code> pair in the <code class="highlighter-rouge">topic</code> field
+and the <code class="highlighter-rouge"><label></code> in the <code class="highlighter-rouge">path</code> field.</p>
+
+<h3 id="command-5">Command</h3>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge"><namespace>/<policyName>/policies/commands/retrieve</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/entries/<label>/resources</code></td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="response-5">Response</h3>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th> </th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge"><namespace>/<policyName>/policies/commands/retrieve</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/entries/<label>/resources</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td> </td>
+ <td>The resources of the Policy as JSON object, see <a href="protocol-specification-policies.html#policy-representation">Policy representation (JSON)</a>.</td>
+ </tr>
+ <tr>
+ <td><strong>status</strong></td>
+ <td><em>code</em></td>
+ <td> </td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td><code class="highlighter-rouge">200</code></td>
+ <td>Success.</td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong> <a href="protocol-examples-policies-retrieveresources.html">Retrieve all resources</a></p>
+
+<h2 id="retrieve-a-single-policy-resources">Retrieve a single Policy resources</h2>
+
+<p>Retrieve a resource identified by the <code class="highlighter-rouge"><namespace>/<policyName></code> pair in the <code class="highlighter-rouge">topic</code> field and the <code class="highlighter-rouge"><label></code> and
+ <code class="highlighter-rouge"><resource></code> in the <code class="highlighter-rouge">path</code>field.</p>
+
+<h3 id="command-6">Command</h3>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge"><namespace>/<policyName>/policies/commands/retrieve</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/entries/<label>/resources/<resource></code></td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="response-6">Response</h3>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th> </th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge"><namespace>/<policyName>/policies/commands/retrieve</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/entries/<label>/resources/<resource></code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td> </td>
+ <td>The resource of the policy as JSON object, see <a href="protocol-specification-policies.html#policy-representation">Policy representation (JSON)</a>.</td>
+ </tr>
+ <tr>
+ <td><strong>status</strong></td>
+ <td><em>code</em></td>
+ <td> </td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td><code class="highlighter-rouge">200</code></td>
+ <td>Success.</td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong> <a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></p>
+
+<h2 id="common-errors">Common errors</h2>
+
+<table>
+ <thead>
+ <tr>
+ <th><strong>status</strong></th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><code class="highlighter-rouge">400</code></td>
+ <td>Bad Format - The request could not be completed due to malformed request syntax.</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">401</code></td>
+ <td>Unauthorized - The request could not be completed due to missing authentication.</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">403</code></td>
+ <td>Forbidden - The Policy could not be modified as the requester had insufficient permissions (‘WRITE’ is required).</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">404</code></td>
+ <td>Not Found - The request could not be completed. The Policy with the given ID was not found in the context of the authenticated user.</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">412</code></td>
+ <td>Precondition Failed - A precondition for reading or writing the (sub-)resource failed. This will happen for write requests, if you specified an If-Match or If-None-Match header, which fails the precondition check against the current ETag of the (sub-)resource.</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">413</code></td>
+ <td>Request Entity Too Large - The created or modified entity is larger than the accepted limit of 100 kB.</td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td>See <a href="protocol-examples-policies-errorresponses.html">Policy Error Responses</a> for examples of other error responses.</td>
+ </tr>
+ </tbody>
+</table>
+
+
+ <div class="tags">
+
+ <b>Tags: </b>
+
+
+
+ <a href="tag_protocol.html" class="btn btn-default navbar-btn cursorNorm" role="button">protocol</a>
+
+
+
+ </div>
+
+</div>
+
+<hr class="shaded"/>
+
+<footer>
+ <div class="row">
+ <div class="col-lg-12 footer">
+ <div class="logo">
+ <a href="https://eclipse.org"><img src="images/eclipse_foundation_logo.svg" alt="Eclipse logo"/></a>
+ </div>
+ <p class="notice">
+ ©2020 Eclipse Ditto.
+ Site last generated: Jul 1, 2020 <br />
+ </p>
+ <div class="quickLinks">
+ <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
+ > Privacy Policy
+ </a>
+ <a href="https://www.eclipse.org/legal/termsofuse.php" target="_blank">
+ > Terms of Use
+ </a>
+ <a href="https://www.eclipse.org/legal/copyright.php" target="_blank">
+ > Copyright Agent
+ </a>
+ <a href="https://www.eclipse.org/legal" target="_blank">
+ > Legal
+ </a>
+ <a href="https://www.eclipse.org/legal/epl-2.0/" target="_blank">
+ > License
+ </a>
+ <a href="https://eclipse.org/security" target="_blank">
+ > Report a Vulnerability
+ </a>
+ </div>
+ </div>
+ </div>
+</footer>
+
+
+ </div>
+ <!-- /.row -->
+</div>
+<!-- /.container -->
+</div>
+<!-- /#main -->
+ </div>
+
+</body>
+</html>
diff --git a/1.0/protocol-specification-policies.html b/1.0/protocol-specification-policies.html
new file mode 100644
index 0000000..6d8d640
--- /dev/null
+++ b/1.0/protocol-specification-policies.html
@@ -0,0 +1,1631 @@
+<!DOCTYPE html>
+<html>
+<head>
+ <meta charset="utf-8">
+<meta http-equiv="X-UA-Compatible" content="IE=edge">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="description" content="">
+<meta name="keywords" content="protocol, protocol, specification, general, policy, policies">
+<title> Protocol specification for Policies • Eclipse Ditto • a digital twin framework</title>
+
+<link rel="stylesheet" href="css/syntax.css">
+<link rel="stylesheet" type="text/css" href="//cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/modern-business.css">
+<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/customstyles.css">
+<link rel="stylesheet" href="css/boxshadowproperties.css">
+<link rel="stylesheet" href="css/theme-ditto.css">
+<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:400,700|Source+Code+Pro:300,600|Titillium+Web:400,600,700">
+
+<script src="//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.4/jquery.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/js/bootstrap.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/anchor-js/2.0.0/anchor.min.js" crossorigin="anonymous"></script>
+<script src="js/toc.js"></script>
+<script src="js/customscripts.js"></script>
+
+<script type="application/ld+json">
+{
+ "@context": "http://schema.org",
+ "@type": "Organization",
+ "url": "https://eclipse.org/ditto/",
+ "logo": "https://eclipse.org/ditto/images/ditto.svg"
+}
+</script>
+
+<link rel="icon" type="image/png" href="images/favicon-16x16.png" sizes="16x16">
+<link rel="icon" type="image/png" href="images/favicon-32x32.png" sizes="32x32">
+<link rel="icon" type="image/png" href="images/favicon-96x96.png" sizes="96x96">
+
+<link rel="alternate" type="application/rss+xml" title="Eclipse Ditto Blog" href="https://www.eclipse.org/ditto/feed.xml">
+
+<!-- Eclipse Foundation cookie consent: -->
+<link rel="stylesheet" type="text/css" href="//www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css" />
+<script src="//www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+ <script>
+ $(document).ready(function() {
+ $("#tg-sb-link").click(function() {
+ $("#tg-sb-sidebar").toggle();
+ $("#tg-sb-content").toggleClass('col-md-9');
+ $("#tg-sb-content").toggleClass('col-md-12');
+ $("#tg-sb-icon").toggleClass('fa-toggle-on');
+ $("#tg-sb-icon").toggleClass('fa-toggle-off');
+ });
+ });
+ </script>
+</head>
+
+
+<script>
+ (function(w,d,s,l,i){
+ w[l]=w[l]||[];
+ w[l].push({'gtm.start':
+ new Date().getTime(),event:'gtm.js'});
+ var f=d.getElementsByTagName(s)[0],
+ j=d.createElement(s),
+ dl=l!='dataLayer'?'&l='+l:'';
+ j.async=true;
+ j.src='https://www.googletagmanager.com/gtm.js?id='+i+dl;
+ f.parentNode.insertBefore(j,f);
+ })(window,document,'script','dataLayer','GTM-5WLCZXC');
+</script>
+
+
+
+<body>
+<!-- Navigation -->
+<nav class="navbar navbar-inverse navbar-fixed-top">
+ <div class="container topnavlinks">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-ditto-home" href="index.html"> <img src="images/ditto_allwhite_symbolonly.svg" class="ditto-navbar-symbol" alt="Home"> <img src="images/ditto_allwhite_textonly.svg" class="ditto-navbar-symbol-text" alt="Ditto"></a>
+ </div>
+ <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
+ <ul class="nav navbar-nav navbar-right">
+ <!-- toggle sidebar button -->
+ <!--<li><a id="tg-sb-link" href="#"><i id="tg-sb-icon" class="fa fa-toggle-on"></i> Nav</a></li>-->
+ <!-- entries without drop-downs appear here -->
+
+
+
+
+
+
+
+ <li><a href="blog.html">Blog</a></li>
+
+
+
+ <li><a href="intro-overview.html">Documentation</a></li>
+
+
+
+ <li><a href="http-api-doc.html">HTTP API</a></li>
+
+
+
+ <li><a href="https://ditto.eclipse.org" target="_blank">Sandbox</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">GitHub</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">GitHub examples</a></li>
+
+
+
+ <!-- entries with drop-downs appear here -->
+ <!-- conditional logic to control which topnav appears for the audience defined in the configuration file.-->
+
+
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Links<b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+
+ <li><a href="https://projects.eclipse.org/projects/iot.ditto" target="_blank">Eclipse Ditto Project</a></li>
+
+
+
+ <li><a href="https://www.eclipse.org/forums/index.php/f/364/" target="_blank">Forum</a></li>
+
+
+
+ <li><a href="https://ci.eclipse.org/ditto/" target="_blank">Jenkins</a></li>
+
+
+
+ <li><a href="https://dev.eclipse.org/mhonarc/lists/ditto-dev/" target="_blank">Mailing list archives</a></li>
+
+
+
+ <li><a href="https://gitter.im/eclipse/ditto" target="_blank">Gitter.im chat</a></li>
+
+
+ </ul>
+ </li>
+
+
+
+ <!--comment out this block if you want to hide search-->
+ <li>
+ <!--start search-->
+ <div id="search-demo-container">
+ <input type="text" id="search-input" placeholder="search...">
+ <ul id="results-container"></ul>
+ </div>
+ <script src="//cdnjs.cloudflare.com/ajax/libs/simple-jekyll-search/0.0.9/jekyll-search.js" type="text/javascript"></script>
+ <script type="text/javascript">
+ SimpleJekyllSearch.init({
+ searchInput: document.getElementById('search-input'),
+ resultsContainer: document.getElementById('results-container'),
+ dataSource: 'search.json',
+ searchResultTemplate: '<li><a href="{url}" title="Protocol specification for Policies">{title}</a></li>',
+ noResultsText: 'No results found.',
+ limit: 10,
+ fuzzy: true,
+ })
+ </script>
+ <!--end search-->
+ </li>
+ </ul>
+ </div>
+ </div>
+ <!-- /.container -->
+</nav>
+
+<!-- Page Content -->
+<div class="container">
+ <div id="main">
+ <!-- Content Row -->
+ <div class="row">
+
+
+ <!-- Sidebar Column -->
+ <div class="col-md-3" id="tg-sb-sidebar">
+
+
+<ul id="mysidebar" class="nav">
+ <li class="sidebarTitle">
+ <label for="docVersion">Eclipse Ditto version:</label>
+ <div class="select-wrapper">
+ <select id="docVersion" name="docVersion">
+
+ <option value="">development</option>
+
+ <option value="1.0">1.0</option>
+
+ <option value="1.1">1.1</option>
+
+ </select>
+ </div>
+ <div id="dev-warning">
+ <div markdown="span" class="alert alert-warning" role="alert" style="font-size:0.6em"><i class="fa fa-warning"></i> <b>Important:</b> This documentation reflects the latest 'development'. You might want to choose a released version.</div>
+ </div>
+ </li>
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Introduction</a>
+ <ul>
+
+
+
+ <li><a href="intro-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="intro-digitaltwins.html">Digital twins</a></li>
+
+
+
+
+
+
+ <li><a href="intro-hello-world.html">Hello world</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Release Notes</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_100.html">1.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_090.html">0.9.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_080.html">0.8.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Milestone releases</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_100-M2.html">1.0.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_100-M1a.html">1.0.0-M1a</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M2.html">0.9.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M1.html">0.9.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M3.html">0.8.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M2.html">0.8.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M1.html">0.8.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M2.html">0.3.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M1.html">0.3.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_020-M1.html">0.2.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M3.html">0.1.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M1.html">0.1.0-M1</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Installation</a>
+ <ul>
+
+
+
+ <li><a href="installation-building.html">Building Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-running.html">Running Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-operating.html">Operating Ditto</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Basic concepts</a>
+ <ul>
+
+
+
+ <li><a href="basic-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Model entities</a>
+ <ul>
+
+
+
+ <li><a href="basic-thing.html">Thing</a></li>
+
+
+
+
+
+ <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
+
+
+
+
+
+ <li><a href="basic-feature.html">Feature</a></li>
+
+
+
+
+
+ <li><a href="basic-policy.html">Policy</a></li>
+
+
+
+
+
+ <li><a href="basic-namespaces-and-names.html">Namespaces and Names</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-auth.html">Authentication and Authorization</a></li>
+
+
+
+
+
+
+ <li><a href="basic-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="basic-signals.html">Signals</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Signal types</a>
+ <ul>
+
+
+
+ <li><a href="basic-signals-command.html">Command</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-commandresponse.html">Command response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-errorresponse.html">Error response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-event.html">Event</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-apis.html">APIs</a></li>
+
+
+
+
+
+
+ <li><a href="basic-connections.html">Connections</a></li>
+
+
+
+
+
+
+ <li><a href="basic-placeholders.html">Placeholders</a></li>
+
+
+
+
+
+
+ <li><a href="basic-changenotifications.html">Change notifications</a></li>
+
+
+
+
+
+
+ <li><a href="basic-rql.html">RQL expressions</a></li>
+
+
+
+
+
+
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
+ <li><a href="basic-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Architecture</a>
+ <ul>
+
+
+
+ <li><a href="architecture-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Services</a>
+ <ul>
+
+
+
+ <li><a href="architecture-services-policies.html">Policies</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things.html">Things</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things-search.html">Things-Search</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-connectivity.html">Connectivity</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-concierge.html">Concierge</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-gateway.html">Gateway</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>HTTP API</a>
+ <ul>
+
+
+
+ <li><a href="httpapi-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-concepts.html">Concepts</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-protocol-bindings-websocket.html">WebSocket protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-sse.html">Server sent events</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Connectivity API</a>
+ <ul>
+
+
+
+ <li><a href="connectivity-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-manage-connections.html">Manage connections</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp091.html">AMQP 0.9.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp10.html">AMQP 1.0 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-kafka2.html">Kafka 2.x protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-mapping.html">Payload mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-header-mapping.html">Header mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-tls-certificates.html">TLS certificates</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Client SDK</a>
+ <ul>
+
+
+
+ <li><a href="client-sdk-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-java.html">Java</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-javascript.html">JavaScript</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Ditto Protocol</a>
+ <ul>
+
+
+
+ <li><a href="protocol-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-twinlive.html">Twin/live channel</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification.html">Specification</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-topic.html">Protocol topic</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-things.html">Things group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-delete.html">Delete</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ search/messages</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-search.html">Search</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-messages.html">Messages</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li class="active"><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-bindings.html">Bindings</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-examples.html">Examples</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-creatething.html">Create a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletething.html">Delete a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifything.html">Modify a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievething.html">Retrieve a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethings.html">Retrieve multiple Things</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattributes.html">Delete Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattributes.html">Modify Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattributes.html">Retrieve Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattribute.html">Create a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattribute.html">Delete a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattribute.html">Modify a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattribute.html">Retrieve a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createthingdefinition.html">Create a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletethingdefinition.html">Delete a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifythingdefinition.html">Modify a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethingdefinition.html">Retrieve a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeatures.html">Create Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeatures.html">Delete Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeatures.html">Modify Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeatures.html">Retrieve Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeature.html">Create a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeature.html">Delete a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeature.html">Modify a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeature.html">Retrieve a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdefinition.html">Create Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedefinition.html">Delete Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydefinition.html">Modify Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedefinition.html">Retrieve Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperties.html">Create Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperties.html">Delete Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperties.html">Modify Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperties.html">Retrieve Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperty.html">Create a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperty.html">Delete a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperty.html">Modify a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperty.html">Retrieve a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li><a href="sandbox.html">Sandbox</a></li>
+
+
+
+
+
+ <li><a href="presentations.html">Presentations</a></li>
+
+
+
+
+
+ <li><a href="glossary.html">Glossary</a></li>
+
+
+
+
+
+ <li><a href="feedback.html">Feedback</a></li>
+
+
+
+
+
+ <p class="external">
+ <a href="#" id="collapseAll">Collapse All</a> | <a href="#" id="expandAll">Expand All</a>
+ </p>
+
+</ul>
+
+<!-- this highlights the active parent class in the sidebar. this is critical so that the parent expands when you're viewing a page. This must appear below the sidebar code above. Otherwise, if placed inside customscripts.js, the script runs before the sidebar code runs and the class never gets inserted.-->
+<script>$("li.active").parents('li').toggleClass("active");
+
+$(function() {
+ $("#dev-warning").hide();
+ changeSelectedDocVersionDropdownSelection($("#docVersion")[0]);
+ $("#docVersion").change(changeSelectedDocVersion);
+});
+
+function changeSelectedDocVersionDropdownSelection(element) {
+ var pathName = window.location.pathname;
+
+ var versionOptions = element.options;
+ for (var i = 0; i < versionOptions.length; i++) {
+ var versionValue = versionOptions[i].value;
+ if ((versionValue !== "") && pathName.startsWith("/ditto/"+versionValue+"/")) {
+ $("#docVersion").val(versionValue).change();
+ return;
+ }
+ }
+ // fallback: dev with "empty" version value:
+ $("#docVersion").val("").change();
+ $("#dev-warning").show();
+}
+function changeSelectedDocVersion() {
+ var versionValue = $('#docVersion').val();
+ var remainingPath = window.location.pathname.replace("/ditto/", "");
+ var versionMatch = remainingPath.match("([0-9].[0.9])/(.*)");
+ if (versionValue === "" && !versionMatch) {
+ // do nothing, we're already on the correct "dev" version
+ } else if (versionMatch && (versionValue === versionMatch[1])) {
+ // do nothing, we're already on the correct version
+ } else {
+ if (versionValue === "" && versionMatch) {
+ window.location.pathname = "ditto/" + versionMatch[2];
+ } else if (versionValue === "") {
+ window.location.pathname = "ditto/" + remainingPath;
+ } else if (versionMatch) {
+ window.location.pathname = "ditto/" + versionValue + "/" + versionMatch[2];
+ } else {
+ window.location.pathname = "ditto/" + versionValue + "/" + remainingPath;
+ }
+ }
+}
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Protocol specification for Policies</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+
+
+
+<!-- this handles the automatic toc. use ## for subheads to auto-generate the on-page minitoc. if you use html tags, you must supply an ID for the heading element in order for it to appear in the minitoc. -->
+<script>
+$( document ).ready(function() {
+ // Handler for .ready() called.
+
+$('#toc').toc({ minimumHeaders: 0, listType: 'ul', showSpeed: 0, headers: 'h2,h3,h4' });
+
+/* this offset helps account for the space taken up by the floating toolbar. */
+$('#toc').on('click', 'a', function() {
+ var target = $(this.getAttribute('href'))
+ , scroll_target = target.offset().top
+
+ $(window).scrollTop(scroll_target - 10);
+ return false
+})
+
+});
+</script>
+
+<div id="toc"></div>
+
+
+
+
+
+
+
+
+
+ <h2 id="ditto-protocol-topic-structure-for-policies">Ditto Protocol topic structure for Policies</h2>
+
+<p>A valid topic consists of five elements, describing the policy affected by this message and the type of the message:</p>
+
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code><namespace>/<policyName>/policies/commands/<action>
+</code></pre></div></div>
+
+<ol>
+ <li><code class="highlighter-rouge">namespace</code>: the namespace of the Policy.</li>
+ <li><code class="highlighter-rouge">policyName</code>: the name of the Policy.</li>
+ <li><code class="highlighter-rouge">group</code>: the group for addressing Policies is <code class="highlighter-rouge">policies</code>.</li>
+ <li><code class="highlighter-rouge">criterion</code>: the type of Protocol message addressing Policies is <code class="highlighter-rouge">commands</code>.</li>
+ <li><code class="highlighter-rouge">action</code>: the action executed on the Policy:
+ <a href="protocol-specification-policies-create-or-modify.html"><code class="highlighter-rouge">create/modify</code></a>,
+ <a href="protocol-specification-policies-retrieve.html"><code class="highlighter-rouge">retrieve</code></a> or
+ <a href="protocol-specification-policies-delete.html"><code class="highlighter-rouge">delete</code></a>.</li>
+</ol>
+
+<div class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> The topic path of the <em>policies</em> group does not contain a channel unlike the <em>things</em> group.</div>
+
+<h2 id="policy-representation">Policy representation</h2>
+
+<p>The representation of a <code class="highlighter-rouge">Policy</code> is specified as follows:</p>
+
+<script src="docson/widget.js" data-schema="../jsonschema/policy.json"></script>
+
+<h2 id="common-error-responses-for-policies">Common error responses for Policies</h2>
+
+<p>These error responses can occur independent of the command that was sent:</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>status</th>
+ <th>error</th>
+ <th>message</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><code class="highlighter-rouge">400</code></td>
+ <td><code class="highlighter-rouge">policies:id.invalid</code></td>
+ <td>The Policy ID <code class="highlighter-rouge"><policyId></code> is not valid!</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">429</code></td>
+ <td><code class="highlighter-rouge">policies:policy.toomanymodifyingrequests</code></td>
+ <td>Too many modifying requests are already outstanding to the Policy with ID <code class="highlighter-rouge"><policyId></code>.</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">503</code></td>
+ <td><code class="highlighter-rouge">policies:policy.unavailable</code></td>
+ <td>The Policy with the given ID is not available, please try again later.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h2 id="common-errors">Common errors</h2>
+
+<table>
+ <thead>
+ <tr>
+ <th><strong>status</strong></th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><code class="highlighter-rouge">400</code></td>
+ <td>Bad Format - The request could not be completed due to malformed request syntax.</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">401</code></td>
+ <td>Unauthorized - The request could not be completed due to missing authentication.</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">403</code></td>
+ <td>Forbidden - The Policy could not be modified as the requester had insufficient permissions (‘WRITE’ is required).</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">404</code></td>
+ <td>Not Found - The request could not be completed. The Policy with the given ID was not found in the context of the authenticated user.</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">412</code></td>
+ <td>Precondition Failed - A precondition for reading or writing the (sub-)resource failed. This will happen for write requests, if you specified an If-Match or If-None-Match header, which fails the precondition check against the current ETag of the (sub-)resource.</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">413</code></td>
+ <td>Request Entity Too Large - The created or modified entity is larger than the accepted limit of 100 kB.</td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td>See <a href="protocol-examples-policies-errorresponses.html">Policy Error Responses</a> for examples of other error responses.</td>
+ </tr>
+ </tbody>
+</table>
+
+
+ <div class="tags">
+
+ <b>Tags: </b>
+
+
+
+ <a href="tag_protocol.html" class="btn btn-default navbar-btn cursorNorm" role="button">protocol</a>
+
+
+
+ </div>
+
+</div>
+
+<hr class="shaded"/>
+
+<footer>
+ <div class="row">
+ <div class="col-lg-12 footer">
+ <div class="logo">
+ <a href="https://eclipse.org"><img src="images/eclipse_foundation_logo.svg" alt="Eclipse logo"/></a>
+ </div>
+ <p class="notice">
+ ©2020 Eclipse Ditto.
+ Site last generated: Jul 1, 2020 <br />
+ </p>
+ <div class="quickLinks">
+ <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
+ > Privacy Policy
+ </a>
+ <a href="https://www.eclipse.org/legal/termsofuse.php" target="_blank">
+ > Terms of Use
+ </a>
+ <a href="https://www.eclipse.org/legal/copyright.php" target="_blank">
+ > Copyright Agent
+ </a>
+ <a href="https://www.eclipse.org/legal" target="_blank">
+ > Legal
+ </a>
+ <a href="https://www.eclipse.org/legal/epl-2.0/" target="_blank">
+ > License
+ </a>
+ <a href="https://eclipse.org/security" target="_blank">
+ > Report a Vulnerability
+ </a>
+ </div>
+ </div>
+ </div>
+</footer>
+
+
+ </div>
+ <!-- /.row -->
+</div>
+<!-- /.container -->
+</div>
+<!-- /#main -->
+ </div>
+
+</body>
+</html>
diff --git a/1.0/protocol-specification-things-create-or-modify.html b/1.0/protocol-specification-things-create-or-modify.html
index c0a004f..bbd27b0 100644
--- a/1.0/protocol-specification-things-create-or-modify.html
+++ b/1.0/protocol-specification-things-create-or-modify.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1272,7 +1493,7 @@
<tbody>
<tr>
<td><strong>topic</strong></td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/commands/create</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/create</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1299,7 +1520,7 @@
<tr>
<td><strong>topic</strong></td>
<td> </td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/commands/create</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/create</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1348,7 +1569,7 @@
<tbody>
<tr>
<td><strong>topic</strong></td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/events/created</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/created</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1380,7 +1601,7 @@
<tbody>
<tr>
<td><strong>topic</strong></td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/commands/modify</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/modify</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1412,7 +1633,7 @@
<tr>
<td><strong>topic</strong></td>
<td> </td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/commands/modify</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/modify</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1471,7 +1692,7 @@
<tbody>
<tr>
<td><strong>topic</strong></td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/events/modified</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/modified</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1505,7 +1726,7 @@
<tbody>
<tr>
<td><strong>topic</strong></td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/commands/modify</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/modify</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1532,7 +1753,7 @@
<tr>
<td><strong>topic</strong></td>
<td> </td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/commands/modify</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/modify</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1592,7 +1813,7 @@
<tbody>
<tr>
<td><strong>topic</strong></td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/events/modified</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/modified</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1619,7 +1840,7 @@
<tbody>
<tr>
<td><strong>topic</strong></td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/events/created</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/created</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1652,7 +1873,7 @@
<tbody>
<tr>
<td><strong>topic</strong></td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/commands/modify</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/modify</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1679,7 +1900,7 @@
<tr>
<td><strong>topic</strong></td>
<td> </td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/commands/modify</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/modify</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1739,7 +1960,7 @@
<tbody>
<tr>
<td><strong>topic</strong></td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/events/modified</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/modified</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1766,7 +1987,7 @@
<tbody>
<tr>
<td><strong>topic</strong></td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/events/created</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/created</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1798,7 +2019,7 @@
<tbody>
<tr>
<td><strong>topic</strong></td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/commands/modify</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/modify</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1825,7 +2046,7 @@
<tr>
<td><strong>topic</strong></td>
<td> </td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/commands/modify</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/modify</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1885,7 +2106,7 @@
<tbody>
<tr>
<td><strong>topic</strong></td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/events/modified</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/modified</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1912,7 +2133,7 @@
<tbody>
<tr>
<td><strong>topic</strong></td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/events/created</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/created</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1944,7 +2165,7 @@
<tbody>
<tr>
<td><strong>topic</strong></td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/commands/modify</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/modify</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1971,7 +2192,7 @@
<tr>
<td><strong>topic</strong></td>
<td> </td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/commands/modify</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/modify</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1991,7 +2212,7 @@
<tr>
<td> </td>
<td><code class="highlighter-rouge">201</code></td>
- <td>Success - the Features were created successfully.</td>
+ <td>Success - The Features were created successfully.</td>
</tr>
<tr>
<td> </td>
@@ -2031,7 +2252,7 @@
<tbody>
<tr>
<td><strong>topic</strong></td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/events/modified</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/modified</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -2058,7 +2279,7 @@
<tbody>
<tr>
<td><strong>topic</strong></td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/events/created</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/created</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -2089,7 +2310,7 @@
<tbody>
<tr>
<td><strong>topic</strong></td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/commands/modify</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/modify</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -2116,7 +2337,7 @@
<tr>
<td><strong>topic</strong></td>
<td> </td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/commands/modify</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/modify</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -2136,7 +2357,7 @@
<tr>
<td> </td>
<td><code class="highlighter-rouge">201</code></td>
- <td>Success - the Feature was created successfully.</td>
+ <td>Success - The Feature was created successfully.</td>
</tr>
<tr>
<td> </td>
@@ -2176,7 +2397,7 @@
<tbody>
<tr>
<td><strong>topic</strong></td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/events/modified</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/modified</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -2203,7 +2424,7 @@
<tbody>
<tr>
<td><strong>topic</strong></td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/events/created</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/created</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -2234,7 +2455,7 @@
<tbody>
<tr>
<td><strong>topic</strong></td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/commands/modify</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/modify</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -2261,7 +2482,7 @@
<tr>
<td><strong>topic</strong></td>
<td> </td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/commands/modify</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/modify</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -2321,7 +2542,7 @@
<tbody>
<tr>
<td><strong>topic</strong></td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/events/modified</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/modified</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -2348,7 +2569,7 @@
<tbody>
<tr>
<td><strong>topic</strong></td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/events/created</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/created</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -2379,7 +2600,7 @@
<tbody>
<tr>
<td><strong>topic</strong></td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/commands/modify</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/modify</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -2406,7 +2627,7 @@
<tr>
<td><strong>topic</strong></td>
<td> </td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/commands/modify</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/modify</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -2466,7 +2687,7 @@
<tbody>
<tr>
<td><strong>topic</strong></td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/events/modified</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/modified</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -2493,7 +2714,7 @@
<tbody>
<tr>
<td><strong>topic</strong></td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/events/created</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/created</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -2526,7 +2747,7 @@
<tbody>
<tr>
<td><strong>topic</strong></td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/commands/modify</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/modify</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -2554,7 +2775,7 @@
<tr>
<td><strong>topic</strong></td>
<td> </td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/commands/modify</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/modify</code></td>
<td> </td>
</tr>
<tr>
@@ -2623,7 +2844,7 @@
<tbody>
<tr>
<td><strong>topic</strong></td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/events/modified</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/modified</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -2650,7 +2871,7 @@
<tbody>
<tr>
<td><strong>topic</strong></td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/events/created</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/created</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -2691,7 +2912,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-specification-things-delete.html b/1.0/protocol-specification-things-delete.html
index 7b80c62..d77824c 100644
--- a/1.0/protocol-specification-things-delete.html
+++ b/1.0/protocol-specification-things-delete.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1267,7 +1488,7 @@
<tbody>
<tr>
<td><strong>topic</strong></td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/commands/delete</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/delete</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1290,7 +1511,7 @@
<tr>
<td><strong>topic</strong></td>
<td> </td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/commands/delete</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/delete</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1339,7 +1560,7 @@
<tbody>
<tr>
<td><strong>topic</strong></td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/events/deleted</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/deleted</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1367,7 +1588,7 @@
<tbody>
<tr>
<td><strong>topic</strong></td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/commands/delete</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/delete</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1390,7 +1611,7 @@
<tr>
<td><strong>topic</strong></td>
<td> </td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/commands/delete</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/delete</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1439,7 +1660,7 @@
<tbody>
<tr>
<td><strong>topic</strong></td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/events/deleted</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/deleted</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1467,7 +1688,7 @@
<tbody>
<tr>
<td><strong>topic</strong></td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/commands/delete</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/delete</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1490,7 +1711,7 @@
<tr>
<td><strong>topic</strong></td>
<td> </td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/commands/delete</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/delete</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1539,7 +1760,7 @@
<tbody>
<tr>
<td><strong>topic</strong></td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/events/deleted</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/deleted</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1567,7 +1788,7 @@
<tbody>
<tr>
<td><strong>topic</strong></td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/commands/delete</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/delete</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1590,7 +1811,7 @@
<tr>
<td><strong>topic</strong></td>
<td> </td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/commands/delete</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/delete</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1639,7 +1860,7 @@
<tbody>
<tr>
<td><strong>topic</strong></td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/events/deleted</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/deleted</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1667,7 +1888,7 @@
<tbody>
<tr>
<td><strong>topic</strong></td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/commands/delete</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/delete</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1690,7 +1911,7 @@
<tr>
<td><strong>topic</strong></td>
<td> </td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/commands/delete</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/delete</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1739,7 +1960,7 @@
<tbody>
<tr>
<td><strong>topic</strong></td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/events/deleted</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/deleted</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1767,7 +1988,7 @@
<tbody>
<tr>
<td><strong>topic</strong></td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/commands/delete</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/delete</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1790,7 +2011,7 @@
<tr>
<td><strong>topic</strong></td>
<td> </td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/commands/delete</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/delete</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1839,7 +2060,7 @@
<tbody>
<tr>
<td><strong>topic</strong></td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/events/deleted</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/deleted</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1868,7 +2089,7 @@
<tbody>
<tr>
<td><strong>topic</strong></td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/commands/delete</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/delete</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1891,7 +2112,7 @@
<tr>
<td><strong>topic</strong></td>
<td> </td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/commands/delete</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/delete</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1940,7 +2161,7 @@
<tbody>
<tr>
<td><strong>topic</strong></td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/events/deleted</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/deleted</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1969,7 +2190,7 @@
<tbody>
<tr>
<td><strong>topic</strong></td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/commands/delete</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/delete</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1992,7 +2213,7 @@
<tr>
<td><strong>topic</strong></td>
<td> </td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/commands/delete</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/delete</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -2041,7 +2262,7 @@
<tbody>
<tr>
<td><strong>topic</strong></td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/events/deleted</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/deleted</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -2069,7 +2290,7 @@
<tbody>
<tr>
<td><strong>topic</strong></td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/commands/delete</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/delete</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -2092,7 +2313,7 @@
<tr>
<td><strong>topic</strong></td>
<td> </td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/commands/delete</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/delete</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -2141,7 +2362,7 @@
<tbody>
<tr>
<td><strong>topic</strong></td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/events/deleted</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/deleted</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -2178,7 +2399,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-specification-things-messages.html b/1.0/protocol-specification-things-messages.html
index 1ceaad2..90175a8 100644
--- a/1.0/protocol-specification-things-messages.html
+++ b/1.0/protocol-specification-things-messages.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1533,7 +1754,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-specification-things-retrieve.html b/1.0/protocol-specification-things-retrieve.html
index 222705d..7a4291c 100644
--- a/1.0/protocol-specification-things-retrieve.html
+++ b/1.0/protocol-specification-things-retrieve.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1269,7 +1490,7 @@
<tbody>
<tr>
<td><strong>topic</strong></td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/commands/retrieve</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/retrieve</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1296,7 +1517,7 @@
<tr>
<td><strong>topic</strong></td>
<td> </td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/commands/retrieve</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/retrieve</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1350,7 +1571,7 @@
<tbody>
<tr>
<td><strong>topic</strong></td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/commands/retrieve</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/retrieve</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1373,7 +1594,7 @@
<tr>
<td><strong>topic</strong></td>
<td> </td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/commands/retrieve</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/retrieve</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1428,7 +1649,7 @@
<tbody>
<tr>
<td><strong>topic</strong></td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/commands/retrieve</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/retrieve</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1451,7 +1672,7 @@
<tr>
<td><strong>topic</strong></td>
<td> </td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/commands/retrieve</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/retrieve</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1505,7 +1726,7 @@
<tbody>
<tr>
<td><strong>topic</strong></td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/commands/retrieve</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/retrieve</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1528,7 +1749,7 @@
<tr>
<td><strong>topic</strong></td>
<td> </td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/commands/retrieve</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/retrieve</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1582,7 +1803,7 @@
<tbody>
<tr>
<td><strong>topic</strong></td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/commands/retrieve</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/retrieve</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1605,7 +1826,7 @@
<tr>
<td><strong>topic</strong></td>
<td> </td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/commands/retrieve</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/retrieve</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1660,7 +1881,7 @@
<tbody>
<tr>
<td><strong>topic</strong></td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/commands/retrieve</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/retrieve</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1683,7 +1904,7 @@
<tr>
<td><strong>topic</strong></td>
<td> </td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/commands/retrieve</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/retrieve</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1738,7 +1959,7 @@
<tbody>
<tr>
<td><strong>topic</strong></td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/commands/retrieve</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/retrieve</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1761,7 +1982,7 @@
<tr>
<td><strong>topic</strong></td>
<td> </td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/commands/retrieve</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/retrieve</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1816,7 +2037,7 @@
<tbody>
<tr>
<td><strong>topic</strong></td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/commands/retrieve</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/retrieve</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1839,7 +2060,7 @@
<tr>
<td><strong>topic</strong></td>
<td> </td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/commands/retrieve</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/retrieve</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1894,7 +2115,7 @@
<tbody>
<tr>
<td><strong>topic</strong></td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/commands/retrieve</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/retrieve</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1917,7 +2138,7 @@
<tr>
<td><strong>topic</strong></td>
<td> </td>
- <td><code class="highlighter-rouge"><namespace>/<thingId>/things/<channel>/commands/retrieve</code></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/retrieve</code></td>
</tr>
<tr>
<td><strong>path</strong></td>
@@ -1980,7 +2201,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-specification-things-search.html b/1.0/protocol-specification-things-search.html
index 5c9a827..dc1aad6 100644
--- a/1.0/protocol-specification-things-search.html
+++ b/1.0/protocol-specification-things-search.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1248,7 +1469,365 @@
- <div class="alert alert-danger" role="alert"><i class="fa fa-exclamation-circle"></i> <b>Warning:</b> Search commands are not yet mapped in the Ditto protocol.<br />Stay tuned!</div>
+ <p>The <a href="basic-search.html">search aspect</a> of the Ditto protocol consists of 3 commands and 4 events that together implement
+the <a href="https://reactive-streams.org">reactive-streams</a> protocol over any duplex transport layer.
+For each search request, Ditto acts as the reactive-streams publisher of pages of search results,
+and the client acts as the subscriber.
+By reactive-streams means, the client controls how fast pages are delivered to it and may cancel
+a search request before all results are sent.</p>
+
+<p>While <a href="basic-connections.html">connections</a> do not expose or require a duplex transport layer,
+the search protocol is available for them as well: Send commands from client to Ditto via any
+<a href="basic-connections.html#sources">connection source</a>. For each command, 0 or more events from Ditto to client
+are published to the reply-target of the source.</p>
+
+<p>For reactive-streams on the JVM, a publisher-subscriber pair is identified by a <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/concurrent/Flow.Subscription.html">Subscription</a> object according
+to reference equality.
+Similarly, the search protocol commands and events of one search query are identified by a subscription ID.</p>
+
+<p>Each search protocol command or event corresponds to a reactive-streams <em>signal</em> and are bound
+by the same rules in the <a href="https://github.com/reactive-streams/reactive-streams-jvm/blob/v1.0.3/README.md">reactive-streams specification</a>.</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Reactive-streams signal</th>
+ <th>Search protocol message topic</th>
+ <th>Type</th>
+ <th>Message direction</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/concurrent/Flow.Publisher.html#subscribe(java.util.concurrent.Flow.Subscriber)">Publisher#subscribe</a></td>
+ <td><a href="#subscribe"><code class="highlighter-rouge">_/_/things/twin/search/subscribe</code></a></td>
+ <td>Command</td>
+ <td>Client to Ditto</td>
+ </tr>
+ <tr>
+ <td><a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/concurrent/Flow.Subscription.html#request(long)">Subscription#request</a></td>
+ <td><a href="#request"><code class="highlighter-rouge">_/_/things/twin/search/request</code></a></td>
+ <td>Command</td>
+ <td>Client to Ditto</td>
+ </tr>
+ <tr>
+ <td><a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/concurrent/Flow.Subscription.html#cancel()">Subscription#cancel</a></td>
+ <td><a href="#cancel"><code class="highlighter-rouge">_/_/things/twin/search/cancel</code></a></td>
+ <td>Command</td>
+ <td>Client to Ditto</td>
+ </tr>
+ <tr>
+ <td><a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/concurrent/Flow.Subscriber.html#onSubscribe(java.util.concurrent.Flow.Subscription)">Subscriber#onSubscribe</a></td>
+ <td><a href="#created"><code class="highlighter-rouge">_/_/things/twin/search/created</code></a></td>
+ <td>Event</td>
+ <td>Ditto to Client</td>
+ </tr>
+ <tr>
+ <td><a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/concurrent/Flow.Subscriber.html#onNext(T)">Subscriber#onNext</a></td>
+ <td><a href="#next"><code class="highlighter-rouge">_/_/things/twin/search/next</code></a></td>
+ <td>Event</td>
+ <td>Ditto to Client</td>
+ </tr>
+ <tr>
+ <td><a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/concurrent/Flow.Subscriber.html#onComplete()">Subscriber#onComplete</a></td>
+ <td><a href="#complete"><code class="highlighter-rouge">_/_/things/twin/search/complete</code></a></td>
+ <td>Event</td>
+ <td>Ditto to Client</td>
+ </tr>
+ <tr>
+ <td><a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/concurrent/Flow.Subscriber.html#onError(java.lang.Throwable)">Subscriber#onError</a></td>
+ <td><a href="#failed"><code class="highlighter-rouge">_/_/things/twin/search/failed</code></a></td>
+ <td>Event</td>
+ <td>Ditto to Client</td>
+ </tr>
+ </tbody>
+</table>
+
+<h2 id="interaction-pattern">Interaction pattern</h2>
+
+<p>For one search query, the commands from client to Ditto should follow this protocol:</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>subscribe request* cancel?
+</code></pre></div></div>
+<p>The client should send one <a href="#subscribe">“subscribe”</a> command,
+followed by multiple <a href="#request">“request”</a> commands and an optional <a href="#cancel">“cancel”</a> command.</p>
+
+<p>In response to a <a href="#subscribe">“subscribe”</a> command and after each <a href="#request">“request”</a> command,
+Ditto will send 0 or more events to the client according to the following protocol:</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>created next* (complete | failed)?
+</code></pre></div></div>
+<p>A <a href="#created">“created”</a> event bearing the subscription ID is always sent.
+0 or more <a href="#next">“next”</a> events are sent according to the amount of search results and the number of pages requested by
+the client. A <a href="#complete">“complete”</a> or <a href="#failed">“failed”</a> event comes at the
+end unless the client sends a <a href="#cancel">“cancel”</a> command before the search results are exhausted.</p>
+
+<p>There is no special event in response to a <a href="#cancel">“cancel”</a> command.
+The client may continue to receive buffered <a href="#next">“next”</a>,
+<a href="#complete">“complete”</a> or <a href="#failed">“failed”</a> events after sending a <a href="#cancel">“cancel”</a> command.</p>
+
+<p>In addition to the rules of reactive-streams, Ditto guarantees that no <a href="#complete">“complete”</a> or
+<a href="#failed">“failed”</a> event will arrive
+before the client expresses its readiness by a first <a href="#request">“request”</a> command. The reason is to facilitate
+concurrency at the client side. Without the extra guarantee, a multi-threaded client would have to process a
+<a href="#complete">“complete”</a> or <a href="#failed">“failed”</a> event in parallel of the preceding <a href="#created">“created”</a> event.
+It would put the burden of sequentialization at the client side and complicate the programming there.</p>
+
+<h2 id="commands-from-client-to-ditto">Commands from Client to Ditto</h2>
+
+<h3 id="subscribe">Subscribe</h3>
+
+<p>Sent a <a href="#subscribe">“subscribe”</a> command to Ditto to start receiving search results.
+Ditto will always respond with a <a href="#created">“created”</a> event.</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge">_/_/things/twin/search/subscribe</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/</code></td>
+ </tr>
+ <tr>
+ <td><strong>fields</strong></td>
+ <td>Contains a comma separated list of fields, to describe which things to be included in the search results.</td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>JSON object specifying the search query. <script src="docson/widget.js" data-schema="../jsonschema/protocol-search-subscribe-payload.json"></script></td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td> </td>
+ </tr>
+ </tbody>
+</table>
+
+<p>The standard <a href="basic-rql.html#rql-filter">filter</a>, <a href="basic-search.html#sorting-and-paging-options">options</a>
+and the <a href="basic-search.html#namespaces">namespaces</a> can be specified in the <code class="highlighter-rouge">value</code> field
+of a <a href="#subscribe">“subscribe”</a> command.
+They have identical semantics and default values as other search APIs.
+In particular:</p>
+<ul>
+ <li>When given in the <code class="highlighter-rouge">options</code> field, <code class="highlighter-rouge">size(<count>)</code> limits the number of search results delivered
+in one <a href="#next">“next”</a> event to <code class="highlighter-rouge"><count></code> items. The default value of <code class="highlighter-rouge"><count></code> is 25 and the maximum value is 200.</li>
+ <li>When given in the <code class="highlighter-rouge">options</code> field, <code class="highlighter-rouge">sort(<+"-><property1>, ...)</code> sets the order of search results.
+If not given, the default <code class="highlighter-rouge">sort(+thingId)</code> is used.</li>
+</ul>
+
+<p>The paging options <code class="highlighter-rouge">cursor</code> and <code class="highlighter-rouge">limit</code> of the <a href="httpapi-search.html">HTTP-API</a> are not supported here, because
+they are not meaningful for the search protocol. For the HTTP-API, those options are for iterating through large
+numbers of search results over many HTTP requests in a stateless manner.
+The search protocol is not stateless and does not require the client to keep track of any cursor or offset;
+results of any size are streamed over an arbitrarily long period of time.</p>
+
+<h3 id="request">Request</h3>
+
+<p>After obtaining a subscription ID from a <a href="#created">“created”</a> event,
+use <a href="#request">“request”</a> commands to tell Ditto how many pages of search results you are prepared to receive.
+Ditto will send <a href="#next">“next”</a> events until all requested pages are fulfilled,
+the search results are exhausted, or an error occurred.</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge">_/_/things/twin/search/request</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>JSON object specifying the number of pages to request. <script src="docson/widget.js" data-schema="../jsonschema/protocol-search-request-payload.json"></script></td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td> </td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="cancel">Cancel</h3>
+
+<p>After obtaining a subscription ID from a <a href="#created">“created”</a> event,
+use a <a href="#cancel">“cancel”</a> command to stop Ditto from sending more pages of the search results.
+Pages in-flight may yet arrive, but the client will eventually stop receiving
+events of the same subscription ID.</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge">_/_/things/twin/search/cancel</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>Identifies a search subscription. <script src="docson/widget.js" data-schema="../jsonschema/protocol-search-subscriptionid.json"></script></td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td> </td>
+ </tr>
+ </tbody>
+</table>
+
+<h2 id="events-from-ditto-to-client">Events from Ditto to Client</h2>
+
+<h3 id="created">Created</h3>
+
+<p>To any <a href="#subscribe">“subscribe”</a> command, Ditto will always respond with a <a href="#created">“created”</a> event.</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge">_/_/things/twin/search/created</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>Discloses the ID of a search subscription which all subsequent commands should include. <script src="docson/widget.js" data-schema="../jsonschema/protocol-search-subscriptionid.json"></script></td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td> </td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="next">Next</h3>
+
+<p>Each <a href="#next">“next”</a> event contains one page of the search results.
+Ditto will not send more <a href="#next">“next”</a> events for a given subscription ID than the total number of pages
+requested by previous <a href="#request">“request”</a> commands.</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge">_/_/things/twin/search/next</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>JSON object containing one page of the search results. <script src="docson/widget.js" data-schema="../jsonschema/protocol-search-next-payload.json"></script></td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td> </td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="complete">Complete</h3>
+
+<p>A search subscription ends with a <a href="#complete">“complete”</a> or a <a href="#failed">“failed”</a> event from Ditto,
+or with an <a href="#cancel">“cancel”</a> command from the client.
+Ditto sends a <a href="#complete">“complete”</a> event when all pages of the search results are delivered to the client.</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge">_/_/things/twin/search/complete</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>Identifies a search subscription. <script src="docson/widget.js" data-schema="../jsonschema/protocol-search-subscriptionid.json"></script></td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td> </td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="failed">Failed</h3>
+
+<p>A search subscription ends with a <a href="#complete">“complete”</a> or a <a href="#failed">“failed”</a> event from Ditto,
+or with an <a href="#cancel">“cancel”</a> command from the client.
+Ditto sends a <a href="#failed">“failed”</a> event when an internal error occurred,
+or when the client breaches the reactive-streams specification.
+It is not possible to <a href="#request">“request”</a> more pages of the search results after a <a href="#failed">“failed”</a> event.</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge">_/_/things/twin/search/failed</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>JSON object containing the reason for the failure. <script src="docson/widget.js" data-schema="../jsonschema/protocol-search-failed-payload.json"></script></td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td> </td>
+ </tr>
+ </tbody>
+</table>
<div class="tags">
@@ -1279,7 +1858,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-specification-things.html b/1.0/protocol-specification-things.html
index 5743bbe..fdc1cff 100644
--- a/1.0/protocol-specification-things.html
+++ b/1.0/protocol-specification-things.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1252,12 +1473,12 @@
<p>A valid topic consists of six elements, describing the thing affected by this message and the type of the message:</p>
-<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code><namespace>/<thingId>/things/<channel>/<criterion>/<action>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code><namespace>/<thingName>/things/<channel>/<criterion>/<action>
</code></pre></div></div>
<ol>
<li><code class="highlighter-rouge">namespace</code>: the namespace of the Thing.</li>
- <li><code class="highlighter-rouge">thingId</code>: the Thing ID.</li>
+ <li><code class="highlighter-rouge">thingName</code>: the name of the Thing.</li>
<li><code class="highlighter-rouge">group</code>: the appropriate group for addressing Things is <code class="highlighter-rouge">things</code>.</li>
<li><code class="highlighter-rouge">channel</code>: the channel of the Protocol message; can either be <code class="highlighter-rouge">live</code> or <code class="highlighter-rouge">twin</code>.</li>
<li><code class="highlighter-rouge">criterion</code>: the type of Protocol message; can either be <code class="highlighter-rouge">commands</code>, <code class="highlighter-rouge">events</code>,
@@ -1342,7 +1563,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-specification-topic.html b/1.0/protocol-specification-topic.html
index 5a3d217..60c67b5 100644
--- a/1.0/protocol-specification-topic.html
+++ b/1.0/protocol-specification-topic.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1258,6 +1479,8 @@
<li><code class="highlighter-rouge">org.eclipse.ditto/fancy-car-0815/things/live/events/modified</code></li>
<li><code class="highlighter-rouge">org.eclipse.ditto/fancy-car-23/things/twin/search</code></li>
<li><code class="highlighter-rouge">org.eclipse.ditto/fancy-car-42/things/live/messages/hello.world</code></li>
+ <li><code class="highlighter-rouge">org.eclipse.ditto/fancy-policy-1/policies/commands/create</code></li>
+ <li><code class="highlighter-rouge">org.eclipse.ditto/fancy-policy-1/policies/commands/delete</code></li>
</ul>
<h2 id="namespace">Namespace</h2>
@@ -1277,9 +1500,15 @@
<p>Addressing the <em>things</em> group in the topic path indicates that a <code class="highlighter-rouge">Thing</code> entity is targeted which means that the entity
identifier in the first two segments should be treated as <code class="highlighter-rouge">Thing ID</code>.</p>
+<h3 id="policies-group">Policies Group</h3>
+
+<p>Addressing the <em>policies</em> group in the topic path indicates that a <code class="highlighter-rouge">Policy</code> entity is targeted which means that the entity
+identifier in the first two segments should be treated as <code class="highlighter-rouge">Policy ID</code>.</p>
+
<h2 id="channel">Channel</h2>
-<p>The <code class="highlighter-rouge">{channel}</code> specifies whether the Protocol message is addressed to the <em>digital twin</em> or to the actual <em>live</em> device.</p>
+<p>The <code class="highlighter-rouge">{channel}</code> specifies whether the Protocol message is addressed to the <em>digital twin</em>, to the actual <em>live</em> device
+or to none of both.</p>
<h3 id="twin-channel">Twin channel</h3>
@@ -1304,6 +1533,14 @@
<p>Protocol messages with the <em>messages</em> <code class="highlighter-rouge">{criterion}</code> are only possible on the <em>live</em> channel as Ditto only acts as a
broker of connected actual devices.</p>
+<h3 id="no-channel">No channel</h3>
+
+<p>Some commands (e.g. Policy commands) are not related to an actual device and thus have no associated twin.
+For these commands the <em>twin</em>/<em>live</em> semantics does not fit and consequently they have no channel assigned in the
+ <em>Topic</em> of the Ditto Protocol message.</p>
+
+<p>For example a <em>CreatePolicy</em> command has the following <em>Topic</em>: <code class="highlighter-rouge"><namespace>/<policyName>/policies/commands/create</code></p>
+
<h2 id="criterion">Criterion</h2>
<p>The <code class="highlighter-rouge">{criterion}</code> segment contains the type of action of the Protocol message in the specified entity <code class="highlighter-rouge">{group}</code> and on
@@ -1341,9 +1578,21 @@
<p><em>errors</em> are returned for commands which could not be executed due to client errors or internal server errors.
They contain a <em>status integer</em> which reflects an HTTP status code with the same semantics as in HTTP.</p>
+<h3 id="acks-criterion">Acks criterion</h3>
+
+<p><a href="#commands-criterion">Commands</a> can specify a number of <a href="basic-acknowledgements.html">acknowledgements</a> (ACKs) which
+have to be successfully fulfilled to regard the command as successfully executed.</p>
+
+<p><em>acks</em> can be returned in response to <a href="#events-criterion">events</a> which have defined in their <code class="highlighter-rouge">headers</code>, that specific
+acknowledgement labels were required by the issuing command.<br />
+Acks contain a <em>status integer</em> which reflects a status code with the same semantics as in HTTP, reflecting whether the
+ack was successful (2xx status range) or not (4xx or 5xx status range).<br />
+Acks contain <em>headers</em> which include at least the <code class="highlighter-rouge">correlation-id</code> of the command/event to acknowledge, and optionally
+contain a custom <em>payload</em>.</p>
+
<h2 id="action-optional">Action (optional)</h2>
-<p>For command, event and messages criteria additional actions are available which further distinguish the purpose of a
+<p>For command, event, and messages criteria, additional actions are available, which further distinguish the purpose of a
Protocol message.</p>
<h3 id="command-criterion-actions">Command criterion actions</h3>
@@ -1371,9 +1620,29 @@
<h3 id="messages-criterion-actions">Messages criterion actions</h3>
-<p>For the <em>messages</em> criterion the <em>action</em> segment specifies the message subject and can be freely chosen by the sender
+<p>For the <em>messages</em> criterion, the <em>action</em> segment specifies the message subject, and can be freely chosen by the sender,
provided that it conforms to <a href="https://tools.ietf.org/html/rfc3986">RFC-3986</a> (URI).</p>
+<h3 id="search-criterion-actions">Search criterion actions</h3>
+
+<p>The action of a command or an event of the <a href="protocol-specification-things-search.html">search protocol</a> is</p>
+<ul>
+ <li><code class="highlighter-rouge">subscribe</code>,</li>
+ <li><code class="highlighter-rouge">request</code>,</li>
+ <li><code class="highlighter-rouge">cancel</code>,</li>
+ <li><code class="highlighter-rouge">created</code>,</li>
+ <li><code class="highlighter-rouge">next</code>,</li>
+ <li><code class="highlighter-rouge">complete</code>, or</li>
+ <li><code class="highlighter-rouge">failed</code>.</li>
+</ul>
+
+<h3 id="acknowledgement-criterion-actions">Acknowledgement criterion actions</h3>
+
+<p>For <em>acks</em> criterion, the <em>action</em> segment specifies the identifier, which is defined by the system which issued the ACK.
+The criterion has to match the regular expression <code class="highlighter-rouge">[a-zA-Z0-9-_]{3,64}</code>, i.e. letters of the Latin alphabet, numbers,
+dashes, and underscores.</p>
+
+
<div class="tags">
@@ -1399,7 +1668,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-specification.html b/1.0/protocol-specification.html
index df4509b..d92fa57 100644
--- a/1.0/protocol-specification.html
+++ b/1.0/protocol-specification.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1248,7 +1469,7 @@
- <p>In order to comply with the Ditto Protocol, a Protocol message must consist of</p>
+ <p>In order to comply with the Ditto Protocol, a protocol message must consist of</p>
<ul>
<li>a Ditto Protocol envelope (JSON) and</li>
@@ -1265,7 +1486,7 @@
<h3 id="dittoProtocolEnvelope">Ditto Protocol envelope</h3>
<p>The Ditto Protocol envelope describes the content of the message (the affected thing entity, a message type, protocol
-version etc.) and allows the message to be routed by intermediary nodes to its final destination without parsing the
+version etc.) and allows the message to be routed by intermediary nodes to its final destination, without parsing the
actual payload.</p>
<p>The Protocol envelope is formatted as JSON object (<code class="highlighter-rouge">content-type=application/json</code>) and must correspond to the
@@ -1275,27 +1496,31 @@
<h3 id="dittoProtocolPayload">Ditto Protocol payload (JSON)</h3>
-<p>The Ditto model payload contains the application data, e.g. an updated sensor value or a Thing in JSON representation.
-See the <a href="protocol-specification-things.html">specification for Things</a> for the schema of a Thing.</p>
+<p>The Ditto model payload contains the application data, e.g. an updated sensor value or a Thing in JSON representation.</p>
+
+<ul>
+ <li>See <a href="protocol-specification-things.html">specification for Things</a></li>
+ <li>See <a href="protocol-specification-policies.html">specification for Policies</a></li>
+</ul>
<h3 id="dittoProtocolResponse">Ditto Protocol response</h3>
<p>When sending a <strong>command</strong>, a <strong>response</strong> can be requested.
-A response, can either indicate the success or the failure of the command.
+A response can indicate either the success or the failure of the command.
The Ditto response for a successful command has the following format:</p>
<script src="docson/widget.js" data-schema="../jsonschema/protocol-response.json"></script>
-<p>In case the execution failed an error response with information about the error is sent:</p>
+<p>In case the execution failed, an error response with information about the error is sent:</p>
<script src="docson/widget.js" data-schema="../jsonschema/protocol-error_response.json"></script>
-<p>The following sections specify in detail which fields of the Protocol envelope, payload and response are used to contain
+<p>The following sections specify in detail, which fields of the protocol envelope, payload, and response use to contain
which information.</p>
<h2 id="topic">Topic</h2>
-<p>Protocol messages contain a <a href="protocol-specification-topic.html">topic</a> which is used for</p>
+<p>Protocol messages contain a <a href="protocol-specification-topic.html">topic</a>, which is used for</p>
<ul>
<li>addressing an entity,</li>
<li>defining the <code class="highlighter-rouge">channel</code> (<em>twin</em> vs. <em>live</em>) and</li>
@@ -1305,7 +1530,7 @@
<h2 id="headers">Headers</h2>
<p>Protocol messages contain headers as JSON object with arbitrary content.
-There are some pre-defined headers which have a special meaning for Ditto:</p>
+There are some pre-defined headers, which have a special meaning for Ditto:</p>
<table>
<thead>
@@ -1317,19 +1542,19 @@
</thead>
<tbody>
<tr>
- <td><code class="highlighter-rouge">correlation-id</code></td>
- <td>Used for correlating Protocol messages (e.g. a <strong>command</strong> would have the same correlation-id as the sent back <strong>response</strong> message.</td>
+ <td><code class="highlighter-rouge">content-type</code></td>
+ <td>The content-type of the message, for Ditto Protocol messages: <code class="highlighter-rouge">application/vnd.eclipse.ditto+json</code></td>
<td><code class="highlighter-rouge">String</code></td>
</tr>
<tr>
- <td><code class="highlighter-rouge">version</code></td>
- <td>Determines in which schema version the sent along <code class="highlighter-rouge">payload</code> should be interpreted.</td>
- <td><code class="highlighter-rouge">Number</code> - currently: [1,2]</td>
+ <td><code class="highlighter-rouge">correlation-id</code></td>
+ <td>Used for correlating protocol messages (e.g. a <strong>command</strong> would have the same correlation-id as the sent back <strong>response</strong> message.</td>
+ <td><code class="highlighter-rouge">String</code></td>
</tr>
<tr>
- <td><code class="highlighter-rouge">response-required</code></td>
- <td>Configures for a sent <strong>command</strong> whether a <strong>response</strong> should be sent back.</td>
- <td><code class="highlighter-rouge">Boolean</code> - default: <code class="highlighter-rouge">true</code></td>
+ <td><code class="highlighter-rouge">ditto-originator</code></td>
+ <td>Contains the first authorization subject of the command that caused the sending of this message. Set by Ditto.</td>
+ <td><code class="highlighter-rouge">String</code></td>
</tr>
<tr>
<td><code class="highlighter-rouge">If-Match</code></td>
@@ -1341,17 +1566,38 @@
<td>Has the same semantics as defined for the <a href="httpapi-concepts.html#conditional-requests">HTTP API</a>.</td>
<td><code class="highlighter-rouge">String</code></td>
</tr>
+ <tr>
+ <td><code class="highlighter-rouge">response-required</code></td>
+ <td>Configures for a <strong>command</strong> whether or not a <strong>response</strong> should be sent back.</td>
+ <td><code class="highlighter-rouge">Boolean</code> - default: <code class="highlighter-rouge">true</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">requested-acks</code></td>
+ <td>Defines which <a href="basic-acknowledgements.html">acknowledgements</a> are requested for a command processed by Ditto.</td>
+ <td><code class="highlighter-rouge">JsonArray</code> of <code class="highlighter-rouge">String</code> - default: <code class="highlighter-rouge">["twin-persisted"]</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">timeout</code></td>
+ <td>Defines how long the Ditto server should wait, e.g. applied when waiting for requested acknowledgements.</td>
+ <td><code class="highlighter-rouge">String</code> - e.g.: <code class="highlighter-rouge">42s</code> or <code class="highlighter-rouge">250ms</code> or <code class="highlighter-rouge">1m</code> - default: <code class="highlighter-rouge">60s</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">version</code></td>
+ <td>Determines in which schema version the <code class="highlighter-rouge">payload</code> should be interpreted.</td>
+ <td><code class="highlighter-rouge">Number</code> - currently: [1,2]</td>
+ </tr>
</tbody>
</table>
<p>Custom headers of messages through the <a href="protocol-twinlive.html">live channel</a> are delivered verbatim. When naming
-custom headers, it is best to attach a prefix specific to your application that does not conflict with Ditto or
+custom headers, it is best to attach a prefix specific to your application, that does not conflict with Ditto or
HTTP protocol, for example the prefix <code class="highlighter-rouge">ditto-*</code>.</p>
<ul>
<li><a href="https://www.iana.org/assignments/message-headers/message-headers.xml">Permanent HTTP headers</a> are to be avoided.</li>
<li>Ditto uses the following headers internally. If these headers are set in a Protocol message, they will be ignored
and will not be delivered.
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>channel
+ditto-*
raw-request-url
read-subjects
subject
@@ -1362,7 +1608,7 @@
<h2 id="path">Path</h2>
-<p>Contains a JSON pointer of where to apply the <a href="#value">value</a> of the Protocol message.
+<p>Contains a JSON pointer of where to apply the <a href="#value">value</a> of the protocol message.
May also be <code class="highlighter-rouge">/</code> when the value contains a replacement for the complete addressed entity (e.g. a complete
<a href="basic-thing.html">Thing</a> JSON).</p>
@@ -1372,7 +1618,12 @@
<h2 id="status">Status</h2>
-<p>Some Protocol messages (for example <strong>responses</strong>) contain a HTTP status code which is stored in this field.</p>
+<p>Some protocol messages (for example <strong>responses</strong>) contain a HTTP status code which is stored in this field.</p>
+
+<h2 id="extra">Extra</h2>
+
+<p>When using <a href="basic-enrichment.html">signal enrichment</a>, in order to ask for <code class="highlighter-rouge">extraFields</code> to be included, the
+Ditto Protocol message contains a field <code class="highlighter-rouge">extra</code> containing a JSON object with the selected extra fields.</p>
<div class="tags">
@@ -1399,7 +1650,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-twinlive.html b/1.0/protocol-twinlive.html
index 508978a..2e3576f 100644
--- a/1.0/protocol-twinlive.html
+++ b/1.0/protocol-twinlive.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1269,6 +1490,12 @@
<p>What Ditto however does, when routing <strong>live</strong> commands/messages, is an <a href="basic-auth.html">authorization check</a>.
Thus Ditto ensures that only authorized parties are able to send commands or messages.</p>
+<h2 id="other">Other</h2>
+
+<p>Policy commands do not fit any of the above two categories as they are not directly related to a device. A Policy is
+not a <strong>twin</strong> of a device. Hence, the <strong>live</strong> channel cannot be used to address the device directly.
+Therefore Policy commands have no <em>channel</em> in the Ditto Protocol format specification.</p>
+
<div class="tags">
@@ -1294,7 +1521,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/release_notes_010-M1.html b/1.0/release_notes_010-M1.html
index 382e215..776e1bc 100644
--- a/1.0/release_notes_010-M1.html
+++ b/1.0/release_notes_010-M1.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1279,7 +1500,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/release_notes_010-M3.html b/1.0/release_notes_010-M3.html
index 93068fb..70647a4 100644
--- a/1.0/release_notes_010-M3.html
+++ b/1.0/release_notes_010-M3.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1335,7 +1556,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/release_notes_020-M1.html b/1.0/release_notes_020-M1.html
index c95f67f..054536e 100644
--- a/1.0/release_notes_020-M1.html
+++ b/1.0/release_notes_020-M1.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1320,7 +1541,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/release_notes_030-M1.html b/1.0/release_notes_030-M1.html
index 12f31bf..284486c 100644
--- a/1.0/release_notes_030-M1.html
+++ b/1.0/release_notes_030-M1.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1331,7 +1552,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/release_notes_030-M2.html b/1.0/release_notes_030-M2.html
index febcf12..cdff1c7 100644
--- a/1.0/release_notes_030-M2.html
+++ b/1.0/release_notes_030-M2.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1328,7 +1549,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/release_notes_080-M1.html b/1.0/release_notes_080-M1.html
index b0365e1..d6d791f 100644
--- a/1.0/release_notes_080-M1.html
+++ b/1.0/release_notes_080-M1.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1350,7 +1571,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/release_notes_080-M2.html b/1.0/release_notes_080-M2.html
index 6b89bee..0467f39 100644
--- a/1.0/release_notes_080-M2.html
+++ b/1.0/release_notes_080-M2.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1334,7 +1555,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/release_notes_080-M3.html b/1.0/release_notes_080-M3.html
index f1c8f27..b31b67b 100644
--- a/1.0/release_notes_080-M3.html
+++ b/1.0/release_notes_080-M3.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1338,7 +1559,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/release_notes_080.html b/1.0/release_notes_080.html
index 88f0dd8..10d4e7c 100644
--- a/1.0/release_notes_080.html
+++ b/1.0/release_notes_080.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1303,7 +1524,7 @@
<p>That means that the project <em>could</em> choose to break APIs at any time without prior deprecation.</p>
-<p>We however can already guarantee that at the HTTP API for <a href="basic-overview.html#api-version-1">API version 1 and 2</a> the
+<p>We however can already guarantee that at the HTTP API for <a href="basic-overview.html#api-version-1---deprecated">API version 1 and 2</a> the
API stability is already ensured for the core functionality of managing <code class="highlighter-rouge">things</code> and <code class="highlighter-rouge">policies</code>.</p>
<p>As the commercial product based on Eclipse Ditto, <a href="https://www.bosch-iot-suite.com/things/">Bosch IoT Things</a>, is
@@ -1344,7 +1565,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/release_notes_090-M1.html b/1.0/release_notes_090-M1.html
index 6439808..4d62471 100644
--- a/1.0/release_notes_090-M1.html
+++ b/1.0/release_notes_090-M1.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1316,7 +1537,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/release_notes_090-M2.html b/1.0/release_notes_090-M2.html
index e3fd504..e13ccd1 100644
--- a/1.0/release_notes_090-M2.html
+++ b/1.0/release_notes_090-M2.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1317,7 +1538,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/release_notes_090.html b/1.0/release_notes_090.html
index 02e994c..129ba18 100644
--- a/1.0/release_notes_090.html
+++ b/1.0/release_notes_090.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1336,7 +1557,7 @@
<p>That means that the project <em>could</em> choose to break APIs at any time without prior deprecation.</p>
-<p>We however can already guarantee that at the HTTP API for <a href="basic-overview.html#api-version-1">API version 1 and 2</a> the
+<p>We however can already guarantee that at the HTTP API for <a href="basic-overview.html#api-version-1---deprecated">API version 1 and 2</a> the
API stability is already ensured for the core functionality of managing <code class="highlighter-rouge">things</code> and <code class="highlighter-rouge">policies</code>.</p>
<p>As the commercial product based on Eclipse Ditto, <a href="https://www.bosch-iot-suite.com/things/">Bosch IoT Things</a>, is
@@ -1374,7 +1595,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/release_notes_100-M1a.html b/1.0/release_notes_100-M1a.html
index 33e6093..037ee73 100644
--- a/1.0/release_notes_100-M1a.html
+++ b/1.0/release_notes_100-M1a.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1335,7 +1556,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/release_notes_100-M2.html b/1.0/release_notes_100-M2.html
index f4d8bfe..840ed8a 100644
--- a/1.0/release_notes_100-M2.html
+++ b/1.0/release_notes_100-M2.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1352,7 +1573,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/release_notes_100.html b/1.0/release_notes_100.html
index e249fa7..1e03f59 100644
--- a/1.0/release_notes_100.html
+++ b/1.0/release_notes_100.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li class="active"><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1313,6 +1534,10 @@
<h3 id="migration-notes">Migration notes</h3>
+<p>OpenID Connect URLs are now prefixed with <code class="highlighter-rouge">https://</code> per default. Any configured URLs containing <code class="highlighter-rouge">https://</code> will break the configuration.
+Instead of <code class="highlighter-rouge">https://auth.eclipse.de/auth/realms/ditto</code> it has to be <code class="highlighter-rouge">auth.eclipse.de/auth/realms/ditto</code> instead.
+The Configuration option is <code class="highlighter-rouge">ditto.gateway.authentication.oauth.openid-connect-issuers.myprovider</code>.</p>
+
<p>Because we removed support for suffixed collections with this release, an offline migration with the provided script
is needed.</p>
@@ -1353,7 +1578,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/release_notes_110.html b/1.0/release_notes_110.html
new file mode 100644
index 0000000..8e65838
--- /dev/null
+++ b/1.0/release_notes_110.html
@@ -0,0 +1,1658 @@
+<!DOCTYPE html>
+<html>
+<head>
+ <meta charset="utf-8">
+<meta http-equiv="X-UA-Compatible" content="IE=edge">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="description" content="Version 1.1.0 of Eclipse Ditto, released on 29.04.2020">
+<meta name="keywords" content="release_notes, release notes, announcements, changelog">
+<title> Release notes 1.1.0 • Eclipse Ditto • a digital twin framework</title>
+
+<link rel="stylesheet" href="css/syntax.css">
+<link rel="stylesheet" type="text/css" href="//cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/modern-business.css">
+<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/customstyles.css">
+<link rel="stylesheet" href="css/boxshadowproperties.css">
+<link rel="stylesheet" href="css/theme-ditto.css">
+<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:400,700|Source+Code+Pro:300,600|Titillium+Web:400,600,700">
+
+<script src="//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.4/jquery.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/js/bootstrap.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/anchor-js/2.0.0/anchor.min.js" crossorigin="anonymous"></script>
+<script src="js/toc.js"></script>
+<script src="js/customscripts.js"></script>
+
+<script type="application/ld+json">
+{
+ "@context": "http://schema.org",
+ "@type": "Organization",
+ "url": "https://eclipse.org/ditto/",
+ "logo": "https://eclipse.org/ditto/images/ditto.svg"
+}
+</script>
+
+<link rel="icon" type="image/png" href="images/favicon-16x16.png" sizes="16x16">
+<link rel="icon" type="image/png" href="images/favicon-32x32.png" sizes="32x32">
+<link rel="icon" type="image/png" href="images/favicon-96x96.png" sizes="96x96">
+
+<link rel="alternate" type="application/rss+xml" title="Eclipse Ditto Blog" href="https://www.eclipse.org/ditto/feed.xml">
+
+<!-- Eclipse Foundation cookie consent: -->
+<link rel="stylesheet" type="text/css" href="//www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css" />
+<script src="//www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+ <script>
+ $(document).ready(function() {
+ $("#tg-sb-link").click(function() {
+ $("#tg-sb-sidebar").toggle();
+ $("#tg-sb-content").toggleClass('col-md-9');
+ $("#tg-sb-content").toggleClass('col-md-12');
+ $("#tg-sb-icon").toggleClass('fa-toggle-on');
+ $("#tg-sb-icon").toggleClass('fa-toggle-off');
+ });
+ });
+ </script>
+</head>
+
+
+<script>
+ (function(w,d,s,l,i){
+ w[l]=w[l]||[];
+ w[l].push({'gtm.start':
+ new Date().getTime(),event:'gtm.js'});
+ var f=d.getElementsByTagName(s)[0],
+ j=d.createElement(s),
+ dl=l!='dataLayer'?'&l='+l:'';
+ j.async=true;
+ j.src='https://www.googletagmanager.com/gtm.js?id='+i+dl;
+ f.parentNode.insertBefore(j,f);
+ })(window,document,'script','dataLayer','GTM-5WLCZXC');
+</script>
+
+
+
+<body>
+<!-- Navigation -->
+<nav class="navbar navbar-inverse navbar-fixed-top">
+ <div class="container topnavlinks">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-ditto-home" href="index.html"> <img src="images/ditto_allwhite_symbolonly.svg" class="ditto-navbar-symbol" alt="Home"> <img src="images/ditto_allwhite_textonly.svg" class="ditto-navbar-symbol-text" alt="Ditto"></a>
+ </div>
+ <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
+ <ul class="nav navbar-nav navbar-right">
+ <!-- toggle sidebar button -->
+ <!--<li><a id="tg-sb-link" href="#"><i id="tg-sb-icon" class="fa fa-toggle-on"></i> Nav</a></li>-->
+ <!-- entries without drop-downs appear here -->
+
+
+
+
+
+
+
+ <li><a href="blog.html">Blog</a></li>
+
+
+
+ <li><a href="intro-overview.html">Documentation</a></li>
+
+
+
+ <li><a href="http-api-doc.html">HTTP API</a></li>
+
+
+
+ <li><a href="https://ditto.eclipse.org" target="_blank">Sandbox</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">GitHub</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">GitHub examples</a></li>
+
+
+
+ <!-- entries with drop-downs appear here -->
+ <!-- conditional logic to control which topnav appears for the audience defined in the configuration file.-->
+
+
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Links<b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+
+ <li><a href="https://projects.eclipse.org/projects/iot.ditto" target="_blank">Eclipse Ditto Project</a></li>
+
+
+
+ <li><a href="https://www.eclipse.org/forums/index.php/f/364/" target="_blank">Forum</a></li>
+
+
+
+ <li><a href="https://ci.eclipse.org/ditto/" target="_blank">Jenkins</a></li>
+
+
+
+ <li><a href="https://dev.eclipse.org/mhonarc/lists/ditto-dev/" target="_blank">Mailing list archives</a></li>
+
+
+
+ <li><a href="https://gitter.im/eclipse/ditto" target="_blank">Gitter.im chat</a></li>
+
+
+ </ul>
+ </li>
+
+
+
+ <!--comment out this block if you want to hide search-->
+ <li>
+ <!--start search-->
+ <div id="search-demo-container">
+ <input type="text" id="search-input" placeholder="search...">
+ <ul id="results-container"></ul>
+ </div>
+ <script src="//cdnjs.cloudflare.com/ajax/libs/simple-jekyll-search/0.0.9/jekyll-search.js" type="text/javascript"></script>
+ <script type="text/javascript">
+ SimpleJekyllSearch.init({
+ searchInput: document.getElementById('search-input'),
+ resultsContainer: document.getElementById('results-container'),
+ dataSource: 'search.json',
+ searchResultTemplate: '<li><a href="{url}" title="Release notes 1.1.0">{title}</a></li>',
+ noResultsText: 'No results found.',
+ limit: 10,
+ fuzzy: true,
+ })
+ </script>
+ <!--end search-->
+ </li>
+ </ul>
+ </div>
+ </div>
+ <!-- /.container -->
+</nav>
+
+<!-- Page Content -->
+<div class="container">
+ <div id="main">
+ <!-- Content Row -->
+ <div class="row">
+
+
+ <!-- Sidebar Column -->
+ <div class="col-md-3" id="tg-sb-sidebar">
+
+
+<ul id="mysidebar" class="nav">
+ <li class="sidebarTitle">
+ <label for="docVersion">Eclipse Ditto version:</label>
+ <div class="select-wrapper">
+ <select id="docVersion" name="docVersion">
+
+ <option value="">development</option>
+
+ <option value="1.0">1.0</option>
+
+ <option value="1.1">1.1</option>
+
+ </select>
+ </div>
+ <div id="dev-warning">
+ <div markdown="span" class="alert alert-warning" role="alert" style="font-size:0.6em"><i class="fa fa-warning"></i> <b>Important:</b> This documentation reflects the latest 'development'. You might want to choose a released version.</div>
+ </div>
+ </li>
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Introduction</a>
+ <ul>
+
+
+
+ <li><a href="intro-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="intro-digitaltwins.html">Digital twins</a></li>
+
+
+
+
+
+
+ <li><a href="intro-hello-world.html">Hello world</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Release Notes</a>
+ <ul>
+
+
+
+ <li class="active"><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_100.html">1.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_090.html">0.9.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_080.html">0.8.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Milestone releases</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_100-M2.html">1.0.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_100-M1a.html">1.0.0-M1a</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M2.html">0.9.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M1.html">0.9.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M3.html">0.8.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M2.html">0.8.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M1.html">0.8.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M2.html">0.3.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M1.html">0.3.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_020-M1.html">0.2.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M3.html">0.1.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M1.html">0.1.0-M1</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Installation</a>
+ <ul>
+
+
+
+ <li><a href="installation-building.html">Building Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-running.html">Running Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-operating.html">Operating Ditto</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Basic concepts</a>
+ <ul>
+
+
+
+ <li><a href="basic-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Model entities</a>
+ <ul>
+
+
+
+ <li><a href="basic-thing.html">Thing</a></li>
+
+
+
+
+
+ <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
+
+
+
+
+
+ <li><a href="basic-feature.html">Feature</a></li>
+
+
+
+
+
+ <li><a href="basic-policy.html">Policy</a></li>
+
+
+
+
+
+ <li><a href="basic-namespaces-and-names.html">Namespaces and Names</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-auth.html">Authentication and Authorization</a></li>
+
+
+
+
+
+
+ <li><a href="basic-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="basic-signals.html">Signals</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Signal types</a>
+ <ul>
+
+
+
+ <li><a href="basic-signals-command.html">Command</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-commandresponse.html">Command response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-errorresponse.html">Error response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-event.html">Event</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-apis.html">APIs</a></li>
+
+
+
+
+
+
+ <li><a href="basic-connections.html">Connections</a></li>
+
+
+
+
+
+
+ <li><a href="basic-placeholders.html">Placeholders</a></li>
+
+
+
+
+
+
+ <li><a href="basic-changenotifications.html">Change notifications</a></li>
+
+
+
+
+
+
+ <li><a href="basic-rql.html">RQL expressions</a></li>
+
+
+
+
+
+
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
+ <li><a href="basic-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Architecture</a>
+ <ul>
+
+
+
+ <li><a href="architecture-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Services</a>
+ <ul>
+
+
+
+ <li><a href="architecture-services-policies.html">Policies</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things.html">Things</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things-search.html">Things-Search</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-connectivity.html">Connectivity</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-concierge.html">Concierge</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-gateway.html">Gateway</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>HTTP API</a>
+ <ul>
+
+
+
+ <li><a href="httpapi-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-concepts.html">Concepts</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-protocol-bindings-websocket.html">WebSocket protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-sse.html">Server sent events</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Connectivity API</a>
+ <ul>
+
+
+
+ <li><a href="connectivity-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-manage-connections.html">Manage connections</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp091.html">AMQP 0.9.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp10.html">AMQP 1.0 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-kafka2.html">Kafka 2.x protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-mapping.html">Payload mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-header-mapping.html">Header mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-tls-certificates.html">TLS certificates</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Client SDK</a>
+ <ul>
+
+
+
+ <li><a href="client-sdk-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-java.html">Java</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-javascript.html">JavaScript</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Ditto Protocol</a>
+ <ul>
+
+
+
+ <li><a href="protocol-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-twinlive.html">Twin/live channel</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification.html">Specification</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-topic.html">Protocol topic</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-things.html">Things group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-delete.html">Delete</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ search/messages</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-search.html">Search</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-messages.html">Messages</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-bindings.html">Bindings</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-examples.html">Examples</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-creatething.html">Create a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletething.html">Delete a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifything.html">Modify a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievething.html">Retrieve a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethings.html">Retrieve multiple Things</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattributes.html">Delete Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattributes.html">Modify Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattributes.html">Retrieve Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattribute.html">Create a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattribute.html">Delete a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattribute.html">Modify a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattribute.html">Retrieve a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createthingdefinition.html">Create a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletethingdefinition.html">Delete a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifythingdefinition.html">Modify a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethingdefinition.html">Retrieve a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeatures.html">Create Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeatures.html">Delete Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeatures.html">Modify Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeatures.html">Retrieve Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeature.html">Create a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeature.html">Delete a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeature.html">Modify a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeature.html">Retrieve a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdefinition.html">Create Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedefinition.html">Delete Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydefinition.html">Modify Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedefinition.html">Retrieve Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperties.html">Create Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperties.html">Delete Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperties.html">Modify Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperties.html">Retrieve Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperty.html">Create a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperty.html">Delete a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperty.html">Modify a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperty.html">Retrieve a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li><a href="sandbox.html">Sandbox</a></li>
+
+
+
+
+
+ <li><a href="presentations.html">Presentations</a></li>
+
+
+
+
+
+ <li><a href="glossary.html">Glossary</a></li>
+
+
+
+
+
+ <li><a href="feedback.html">Feedback</a></li>
+
+
+
+
+
+ <p class="external">
+ <a href="#" id="collapseAll">Collapse All</a> | <a href="#" id="expandAll">Expand All</a>
+ </p>
+
+</ul>
+
+<!-- this highlights the active parent class in the sidebar. this is critical so that the parent expands when you're viewing a page. This must appear below the sidebar code above. Otherwise, if placed inside customscripts.js, the script runs before the sidebar code runs and the class never gets inserted.-->
+<script>$("li.active").parents('li').toggleClass("active");
+
+$(function() {
+ $("#dev-warning").hide();
+ changeSelectedDocVersionDropdownSelection($("#docVersion")[0]);
+ $("#docVersion").change(changeSelectedDocVersion);
+});
+
+function changeSelectedDocVersionDropdownSelection(element) {
+ var pathName = window.location.pathname;
+
+ var versionOptions = element.options;
+ for (var i = 0; i < versionOptions.length; i++) {
+ var versionValue = versionOptions[i].value;
+ if ((versionValue !== "") && pathName.startsWith("/ditto/"+versionValue+"/")) {
+ $("#docVersion").val(versionValue).change();
+ return;
+ }
+ }
+ // fallback: dev with "empty" version value:
+ $("#docVersion").val("").change();
+ $("#dev-warning").show();
+}
+function changeSelectedDocVersion() {
+ var versionValue = $('#docVersion').val();
+ var remainingPath = window.location.pathname.replace("/ditto/", "");
+ var versionMatch = remainingPath.match("([0-9].[0.9])/(.*)");
+ if (versionValue === "" && !versionMatch) {
+ // do nothing, we're already on the correct "dev" version
+ } else if (versionMatch && (versionValue === versionMatch[1])) {
+ // do nothing, we're already on the correct version
+ } else {
+ if (versionValue === "" && versionMatch) {
+ window.location.pathname = "ditto/" + versionMatch[2];
+ } else if (versionValue === "") {
+ window.location.pathname = "ditto/" + remainingPath;
+ } else if (versionMatch) {
+ window.location.pathname = "ditto/" + versionValue + "/" + versionMatch[2];
+ } else {
+ window.location.pathname = "ditto/" + versionValue + "/" + remainingPath;
+ }
+ }
+}
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Release notes 1.1.0</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+ <div class="summary">Version 1.1.0 of Eclipse Ditto, released on 29.04.2020</div>
+
+
+
+
+<!-- this handles the automatic toc. use ## for subheads to auto-generate the on-page minitoc. if you use html tags, you must supply an ID for the heading element in order for it to appear in the minitoc. -->
+<script>
+$( document ).ready(function() {
+ // Handler for .ready() called.
+
+$('#toc').toc({ minimumHeaders: 0, listType: 'ul', showSpeed: 0, headers: 'h2,h3,h4' });
+
+/* this offset helps account for the space taken up by the floating toolbar. */
+$('#toc').on('click', 'a', function() {
+ var target = $(this.getAttribute('href'))
+ , scroll_target = target.offset().top
+
+ $(window).scrollTop(scroll_target - 10);
+ return false
+})
+
+});
+</script>
+
+<div id="toc"></div>
+
+
+
+
+
+
+
+
+
+ <p>The first minor (feature adding) release of Eclipse Ditto 1 is finally here: <strong>1.1.0</strong>.</p>
+
+<p>It is API and <a href="https://github.com/eclipse/ditto/blob/master/documentation/src/main/resources/architecture/DADR-0005-semantic-versioning.md">binary compatible</a>
+to Eclipse Ditto 1.0.0.</p>
+
+<h2 id="whats-in-this-release">What’s in this release?</h2>
+
+<h3 id="changelog">Changelog</h3>
+
+<p>Compared to the latest release <a href="release_notes_100.html">1.0.0</a>, the following changes, new features and
+bugfixes were added.</p>
+
+<h4 id="changes">Changes</h4>
+
+<h5 id="java-11-as-runtime-environment"><a href="https://github.com/eclipse/ditto/issues/308">Java 11 as runtime environment</a></h5>
+
+<p>The default Java runtime for Ditto’s Docker containers was switched from Java 8 to Java 11 which should have some
+benefits in storing Strings in memory (this was already added in Java 9).</p>
+
+<p>Language features of newer Java versions can now be used in the “services” part of Ditto, the Java APIs and models relevant
+for <a href="https://github.com/eclipse/ditto/blob/master/documentation/src/main/resources/architecture/DADR-0005-semantic-versioning.md">semantic versioning</a>
+are still compatible to Java 8.</p>
+
+<h5 id="cbor-as-ditto-internal-serialization-provider"><a href="https://github.com/eclipse/ditto/pull/598">CBOR as Ditto internal serialization provider</a></h5>
+
+<p>As a bachelor thesis, <a href="https://github.com/erikescher">Erik Escher</a> evaluated mechanisms to improve the serialization
+overhead done in Ditto clusters.</p>
+
+<p>His findings using <a href="https://cbor.io">CBOR</a> as an alternative to plain JSON resulted an approximate 10% improvement on
+roundtrip times and throughput.
+The Ditto team was happy to accept his pull request, again improving overall performance in Ditto.</p>
+
+<h5 id="more-strict-content-type-parsing-for-http-request-payload"><a href="https://github.com/eclipse/ditto/pull/650">More strict Content-Type parsing for HTTP request payload</a></h5>
+
+<p>In the past, Ditto did not evaluate the HTTP <code class="highlighter-rouge">Content-Type</code> header of HTTP requests sending along payload. As this
+can be a potential security issue (e.g. in scope of CORS requests), the <code class="highlighter-rouge">Content-Type</code> is now strictly enforced to
+be of <code class="highlighter-rouge">application/json</code> wherever Ditto only accepts JSON request payload.</p>
+
+<h4 id="new-features">New features</h4>
+
+<h5 id="management-of-policies-via-ditto-protocol-and-in-java-client"><a href="https://github.com/eclipse/ditto/issues/554">Management of policies via Ditto Protocol and in Java client</a></h5>
+
+<p>The <a href="basic-policy.html">policy</a> entities can now - in addition to their HTTP API - be managed via the
+<a href="protocol-specification-policies.html">Ditto Protocol</a>. That means also via
+<a href="httpapi-protocol-bindings-websocket.html">WebSocket</a> and <a href="basic-connections.html">connections</a> (e.g. AMQP, MQTT, ..).</p>
+
+<p>APIs for <a href="client-sdk-java.html#manage-policies">policy management</a> were also added to the
+<a href="https://github.com/eclipse/ditto-clients/pull/46">Ditto Java Client</a>.</p>
+
+<h5 id="searching-things-via-ditto-protocol-and-in-java-client"><a href="https://github.com/eclipse/ditto/issues/575">Searching things via Ditto Protocol and in Java client</a></h5>
+
+<p>New <a href="protocol-specification-things-search.html">Ditto Protocol for search</a> was added in order to define a search query
+via the Ditto Protocol and also get results via an asynchronous channel. As a result, searching for things is now also
+possible via <a href="httpapi-protocol-bindings-websocket.html">WebSocket</a> and <a href="basic-connections.html">connections</a>
+(e.g. AMQP, MQTT, ..).</p>
+
+<p>APIs for <a href="client-sdk-java.html#search-for-things">searching things</a> were also added to the
+<a href="https://github.com/eclipse/ditto-clients/pull/53">Ditto Java Client</a>.</p>
+
+<h5 id="enriching-messages-and-events-before-publishing-to-external-subscribers"><a href="https://github.com/eclipse/ditto/issues/561">Enriching messages and events before publishing to external subscribers</a></h5>
+
+<p>When subscribing <a href="basic-changenotifications.html">change notifications</a> or for messages to publish to external system or
+deliver via <a href="httpapi-protocol-bindings-websocket.html">WebSocket</a> it is now possible to <a href="basic-enrichment.html">enrich</a>
+the payload with additional “extra fields” from the thing which was affected by the change.</p>
+
+<p>This can be useful when e.g. only a sensor value of a device changes, but your application also needs to be aware of
+additional context of the affected thing (e.g. a location which does not change with each sensor update).</p>
+
+<p>APIs for <a href="client-sdk-java.html#subscribe-to-enriched-change-notifications">enriching changes</a> were also added to the
+<a href="https://github.com/eclipse/ditto-clients/pull/43">Ditto Java Client</a>.</p>
+
+<h5 id="establish-connections-to-mqtt-5-brokers"><a href="https://github.com/eclipse/ditto/issues/561">Establish connections to MQTT 5 brokers</a></h5>
+
+<p>The Ditto community (namely <a href="https://github.com/w4tsn">Alexander Wellbrock (w4tsn)</a> from
+<a href="https://www.othermo.de">othermo GmbH</a>) contributed MQTT 5 support to Ditto’s connectivity capabilities.<br />
+With that is is possible to also establish connections to MQTT 5 brokers and even apply
+<a href="connectivity-header-mapping.html">header mapping</a> and e.g. responses via MQTT 5’s <code class="highlighter-rouge">user properties</code> approach.</p>
+
+<p>Thank you very much for this great contribution.</p>
+
+<h5 id="end-2-end-acknowledgements"><a href="https://github.com/eclipse/ditto/issues/611">End-2-end acknowledgements</a></h5>
+
+<p>Until now, messages consumed by Eclipse Ditto were processed without a guarantee. That is being addressed with this
+first feature addition, the model and logic in order to request and emit <a href="basic-acknowledgements.html">acknowledgements</a>.</p>
+
+<p>The follow-up issue <a href="https://github.com/eclipse/ditto/issues/661">#661</a> will automatically handle acknowledgements
+in Ditto managed connections, configured for connection sources and targets, providing QoS 1 (at least once) semantic
+for message processing in Ditto via connections.</p>
+
+<p>APIs for <a href="client-sdk-java.html#request-and-issue-acknowledgements">requesting and issuing acknowledgements</a> were also
+added to the <a href="https://github.com/eclipse/ditto-clients/pull/56">Ditto Java Client</a>.</p>
+
+<h5 id="pre-authenticated-authentication-mechanism"><a href="https://github.com/eclipse/ditto/issues/560">Pre-authenticated authentication mechanism</a></h5>
+
+<p>Officially added+<a href="installation-operating.html#pre-authentication">documented</a> support of how Ditto external
+authentication providers may be configured to authenticate users in Ditto by adding them as an HTTP reverse proxy in
+front of Ditto.</p>
+
+<h4 id="deprecations">Deprecations</h4>
+
+<h5 id="api-version-1-deprecation"><a href="https://github.com/eclipse/ditto/pull/608">API version 1 deprecation</a></h5>
+
+<p>Now that Ditto has a full replacement for <a href="basic-acl.html">ACLs</a>, namely <a href="basic-policy.html">policies</a> which now can
+also be managed via the <a href="protocol-specification-policies.html">Ditto Protocol</a> and the
+<a href="client-sdk-java.html">Ditto Java client</a>, it is time to deprecate the APIs around the ACL mechanism.</p>
+
+<p>Starting with Ditto 1.1.0, usage of the API in version <code class="highlighter-rouge">1</code> (e.g. contained in HTTP URLs as <code class="highlighter-rouge">/api/1/things...</code>) is
+deprecated.<br />
+API version 1 and ACLs will very likely be removed in Ditto <code class="highlighter-rouge">2.0</code>.</p>
+
+<p>So when you start using Ditto, please make sure to use API version <code class="highlighter-rouge">2</code> (using policies as
+<a href="basic-auth.html#authorization">authorization mechanism</a>) from the very beginning.</p>
+
+<h4 id="bugfixes">Bugfixes</h4>
+
+<p>Several bugs in Ditto 1.0.0 were fixed for 1.1.0.<br />
+This is a complete list of the
+<a href="https://github.com/eclipse/ditto/pulls?q=is%3Apr+milestone%3A1.1.0">merged pull requests</a>, including the fixed bugs.</p>
+
+<h3 id="migration-notes">Migration notes</h3>
+
+<p>Do not apply when updating from Eclipse Ditto 1.0.0 to 1.1.0.</p>
+
+
+ <div class="tags">
+
+ <b>Tags: </b>
+
+
+
+ <a href="tag_release_notes.html" class="btn btn-default navbar-btn cursorNorm" role="button">release_notes</a>
+
+
+
+ </div>
+
+</div>
+
+<hr class="shaded"/>
+
+<footer>
+ <div class="row">
+ <div class="col-lg-12 footer">
+ <div class="logo">
+ <a href="https://eclipse.org"><img src="images/eclipse_foundation_logo.svg" alt="Eclipse logo"/></a>
+ </div>
+ <p class="notice">
+ ©2020 Eclipse Ditto.
+ Site last generated: Jul 1, 2020 <br />
+ </p>
+ <div class="quickLinks">
+ <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
+ > Privacy Policy
+ </a>
+ <a href="https://www.eclipse.org/legal/termsofuse.php" target="_blank">
+ > Terms of Use
+ </a>
+ <a href="https://www.eclipse.org/legal/copyright.php" target="_blank">
+ > Copyright Agent
+ </a>
+ <a href="https://www.eclipse.org/legal" target="_blank">
+ > Legal
+ </a>
+ <a href="https://www.eclipse.org/legal/epl-2.0/" target="_blank">
+ > License
+ </a>
+ <a href="https://eclipse.org/security" target="_blank">
+ > Report a Vulnerability
+ </a>
+ </div>
+ </div>
+ </div>
+</footer>
+
+
+ </div>
+ <!-- /.row -->
+</div>
+<!-- /.container -->
+</div>
+<!-- /#main -->
+ </div>
+
+</body>
+</html>
diff --git a/1.0/sandbox.html b/1.0/sandbox.html
index b132a25..e68a5e8 100644
--- a/1.0/sandbox.html
+++ b/1.0/sandbox.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1324,7 +1545,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/search.json b/1.0/search.json
index 26d58d0..6a49b1a 100644
--- a/1.0/search.json
+++ b/1.0/search.json
@@ -81,7 +81,18 @@
{
-"title": "Access control list (ACL)",
+"title": "Acknowledgements",
+"tags": "model",
+"keywords": "acks, acknowledgement, acknowledgements, qos, at least once",
+"url": "basic-acknowledgements.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Access control list (ACL) - Deprecated",
"tags": "model",
"keywords": "authentication, authorization, auth, acl, access control",
"url": "basic-acl.html",
@@ -116,7 +127,7 @@
{
"title": "Change notifications",
"tags": "modelrql",
-"keywords": "change, event, feature, notification, thing, filtering, rql, push, subscribe, consume",
+"keywords": "change, event, feature, notification, thing, filtering, rql, push, subscribe, consume, enrich, extra",
"url": "basic-changenotifications.html",
"summary": ""
}
@@ -136,6 +147,17 @@
{
+"title": "Signal enrichment",
+"tags": "protocol",
+"keywords": "change, event, enrich, extra, enrichment, fields, extraFields",
+"url": "basic-enrichment.html",
+"summary": ""
+}
+,
+
+
+
+{
"title": "Feature",
"tags": "model",
"keywords": "definition, properties, entity, feature, functionblock, informationmodel, model, vorto",
@@ -203,7 +225,7 @@
{
"title": "RQL expressions",
-"tags": "rql",
+"tags": "rqlprotocol",
"keywords": "rql, query, filter, filtering, search",
"url": "basic-rql.html",
"summary": ""
@@ -444,6 +466,17 @@
{
+"title": "MQTT 5 protocol binding",
+"tags": "protocolconnectivity",
+"keywords": "binding, protocol, mqtt, mqtt5",
+"url": "connectivity-protocol-bindings-mqtt5.html",
+"summary": ""
+}
+,
+
+
+
+{
"title": "Certificates for Transport Layer Security",
"tags": "connectivity",
"keywords": "security, TLS",
@@ -523,17 +556,6 @@
{
-"title": "HTTP API Run in Postman",
-"tags": "http",
-"keywords": "api, http, REST, postman, explore",
-"url": "httpapi-postman.html",
-"summary": ""
-}
-,
-
-
-
-{
"title": "WebSocket protocol binding",
"tags": "protocolhttprql",
"keywords": "binding, protocol, websocket, http",
@@ -558,7 +580,7 @@
{
"title": "HTTP API server sent events (SSE)",
"tags": "httprql",
-"keywords": "http, api, sse, EventSource",
+"keywords": "http, api, sse, EventSource, fields, projection, extra, enrich",
"url": "httpapi-sse.html",
"summary": ""
}
@@ -741,6 +763,56 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
{
"title": "Protocol examples",
"tags": "protocol",
@@ -764,6 +836,61 @@
{
+"title": "Protocol specification for acknowledgements",
+"tags": "protocol",
+"keywords": "protocol, specification, general",
+"url": "protocol-specification-acks.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Policies - Create-Or-Modify protocol specification",
+"tags": "protocol",
+"keywords": "protocol, specification, create, modify, policy",
+"url": "protocol-specification-policies-create-or-modify.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Policies - Delete protocol specification",
+"tags": "protocol",
+"keywords": "protocol, specification, delete, policy",
+"url": "protocol-specification-policies-delete.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Policies - Retrieve protocol specification",
+"tags": "protocol",
+"keywords": "protocol, specification, retrieve, policy",
+"url": "protocol-specification-policies-retrieve.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Protocol specification for Policies",
+"tags": "protocol",
+"keywords": "protocol, specification, general, policy, policies",
+"url": "protocol-specification-policies.html",
+"summary": ""
+}
+,
+
+
+
+{
"title": "Things - Create-Or-Modify protocol specification",
"tags": "protocol",
"keywords": "protocol, specification, create, modify, thing",
@@ -1028,6 +1155,17 @@
{
+"title": "Release notes 1.1.0",
+"tags": "release_notes",
+"keywords": "release notes, announcements, changelog",
+"url": "release_notes_110.html",
+"summary": "Version 1.1.0 of Eclipse Ditto, released on 29.04.2020"
+}
+,
+
+
+
+{
"title": "Sandbox",
"tags": "",
"keywords": "sandbox, demo, trial",
@@ -1086,6 +1224,26 @@
{
+"title": "Announcing Eclipse Ditto Release 1.1.0",
+"tags": "blog",
+"keywords": "",
+"url": "2020-04-29-release-announcement-110.html",
+"summary": ""
+}
+,
+
+
+{
+"title": "Digital twins of devices connected via LoRaWAN to TTN",
+"tags": "blogconnectivity",
+"keywords": "",
+"url": "2020-04-16-connecting-to-ttn-via-mqtt.html",
+"summary": ""
+}
+,
+
+
+{
"title": "Announcing Eclipse Ditto Release 1.0.0",
"tags": "blog",
"keywords": "",
diff --git a/1.0/slides/2020_04_16-ttn-virtual-conference/index.html b/1.0/slides/2020_04_16-ttn-virtual-conference/index.html
new file mode 100644
index 0000000..259e45d
--- /dev/null
+++ b/1.0/slides/2020_04_16-ttn-virtual-conference/index.html
@@ -0,0 +1,700 @@
+<!doctype html>
+<html lang="en">
+
+<head>
+ <meta charset="utf-8">
+
+ <title>Eclipse Ditto: Digital Twins as part of an open IoT platform</title>
+
+ <meta name="description" content="The Things Virtual Conference - Eclipse Ditto workshop">
+ <meta name="author" content="Thomas Jäckle">
+ <meta name="date" content="2020-04-216">
+ <meta http-equiv="content-language" content="en">
+
+ <meta name="apple-mobile-web-app-capable" content="yes">
+ <meta name="apple-mobile-web-app-status-bar-style" content="black-translucent">
+
+ <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no">
+
+ <link rel="icon" type="image/png" href="../../images/favicon-16x16.png" sizes="16x16">
+ <link rel="icon" type="image/png" href="../../images/favicon-32x32.png" sizes="32x32">
+ <link rel="icon" type="image/png" href="../../images/favicon-96x96.png" sizes="96x96">
+
+ <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=News+Cycle">
+ <link rel="stylesheet" href="https://use.fontawesome.com/releases/v5.0.13/css/all.css"
+ integrity="sha384-DNOHZ68U8hZfKXOrtjWvjxusGo9WQnrNx2sqG0tfsghAvtVlRW3tvkXWZh58N9jp" crossorigin="anonymous">
+
+
+ <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/reveal.js/3.6.0/css/reveal.min.css">
+ <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/reveal.js/3.6.0/css/theme/simple.min.css"
+ id="theme">
+
+ <!-- Theme used for syntax highlighting of code -->
+ <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/reveal.js/3.6.0/lib/css/zenburn.min.css">
+
+ <style>
+ @font-face {
+ font-family: "News Cycle";
+ }
+
+ #header-left {
+ position: absolute;
+ top: 0%;
+ left: 0%;
+ opacity: 1 !important;
+ }
+
+ #header-right {
+ position: absolute;
+ top: 0%;
+ right: 0%;
+ opacity: 1 !important;
+ }
+
+ .reveal section img {
+ background: none;
+ border: none;
+ box-shadow: none;
+ }
+
+ .dim-background .slide-background {
+ opacity: 0.3 !important;
+ /*background: none !important; for printing ! */
+ /* print with: file:///C:/...../index.html?print-pdf */
+ }
+
+ .chapter-background .slide-background {
+ opacity: 0.7 !important;
+ /*background: none !important;*/ /* for printing ! */
+ }
+
+ .print-pdf .reveal .slide-background {
+ opacity: 0.7 !important;
+ }
+
+ .dim-background .slide-background.past {
+ display: none !important;
+ }
+
+ .dim-background .slide-background.future {
+ display: none !important;
+ }
+
+ .chapter-background .slide-background.past {
+ display: none !important;
+ }
+
+ .chapter-background .slide-background.future {
+ display: none !important;
+ }
+
+ /*.new-chapter h3 { color: #586e75; }*/
+ .introlink a:link {
+ font-weight: bold;
+ color: #000000
+ }
+
+ /* unvisited links */
+ .introlink a:visited {
+ font-weight: bold;
+ color: #000000
+ }
+
+ /* visited links */
+ .introlink a:hover {
+ font-weight: bold;
+ color: #000000
+ }
+
+ /* user hovers */
+ .introlink a:active {
+ font-weight: bold;
+ color: #000000
+ }
+
+ ul {
+ list-style: none !important;
+ }
+
+ ul li {
+ padding-left: 1.3em;
+ }
+
+ ul li:before {
+ list-style: none;
+ content: "→";
+ display: inline-block;
+ margin-left: -1.3em; /* same as padding-left set on li */
+ width: 1.3em; /* same as padding-left set on li */
+ }
+
+ .footer {
+ font-size: 12px !Important;
+ font-family: "News Cycle", Impact, sans-serif;
+ color: #687175;
+ position: absolute;
+ bottom: 15px;
+ left: 15px;
+ margin-bottom: 10px
+ }
+
+ .footer a {
+ color: #003b6a;
+ text-decoration: none;
+ }
+
+ /* active links */
+ </style>
+
+ <!-- Printing and PDF exports -->
+ <script>
+ var link = document.createElement('link');
+ link.rel = 'stylesheet';
+ link.type = 'text/css';
+ link.href =
+ window.location.search.match(/print-pdf/gi)
+ ? 'https://cdnjs.cloudflare.com/ajax/libs/reveal.js/3.6.0/css/print/pdf.min.css'
+ : 'https://cdnjs.cloudflare.com/ajax/libs/reveal.js/3.6.0/css/print/paper.min.css';
+ document.getElementsByTagName('head')[0].appendChild(link);
+ </script>
+
+ <!--[if lt IE 9]>
+ <script src="https://cdnjs.cloudflare.com/ajax/libs/reveal.js/3.6.0/lib/js/html5shiv.js"></script>
+ <![endif]-->
+</head>
+
+<body>
+
+<div class="reveal">
+
+ <!-- 2. Create hidden header/footer <div> -->
+ <div id="hidden" style="display:none;">
+ <div id="header">
+ <div id="header-left"><img src="../../images/ditto.svg" style="width: 80px; padding-top: 10px; padding-left: 10px" alt="Ditto logo"></div>
+ <div id="header-right"><img src="../../images/2020-04-16-Logo_TTVC_color.png" style="width: 140px; padding-top: 10px; padding-right: 10px" alt="Eclipse IoT logo"></div>
+<!-- <div id="header-right"><img src="../../images/iot_logo.svg" style="width: 120px; padding-top: 10px; padding-right: 10px" alt="Eclipse IoT logo"></div>-->
+ </div>
+ </div>
+
+ <!-- Any section element inside of this container is displayed as a slide -->
+ <div class="slides">
+ <!-- Section: Intro -->
+ <section>
+ <section id="title" class="new-chapter" data-background="../bg-images/background-twin-small.jpg" data-state="chapter-background">
+ <!-- background source: https://unsplash.com/collections/425779/iot -->
+ <h1 style="line-height: 1em">
+ <img src="../../images/iot_logo.svg" style="width: 15%;vertical-align: top; padding-right: 20px" alt="Eclipse IoT">
+ <img src="../../images/ditto.svg" style="width: 15%;vertical-align: middle" alt="Eclipse Ditto">
+ </h1>
+ <h1 style="font-size: 1.5em;">Digital Twins as part of an open IoT platform</h1>
+ <img src="../../images/2020-04-16-Logo_TTVC_color.png" alt="The Things Network Virtual Conference" style="width: 35%;padding-top:0.5em" />
+ <h2 style="font-size: 0.8em">16.04.2020</h2>
+ </section>
+
+<!-- <section id="whoami" class="new-chapter">-->
+<!-- <h2>who am I?</h2>-->
+<!-- <br/>-->
+<!-- <div style="float:left; width: 25%;">-->
+<!-- <img src="../images/thjaeckle_400x400.jpg" alt="Thomas Jäckle" style="width: 100%; border-radius: 50%" />-->
+<!-- <h4>Thomas Jäckle</h4>-->
+<!-- <h4><a href="http://twitter.com/thjaeckle">@thjaeckle</a></h4>-->
+<!-- <br style="clear: both"/>-->
+<!-- </div>-->
+<!-- <div style="float:right; width: 70%;">-->
+<!-- <img src="//www.brand.bosch.com/images/icons/bosch-logo.png" alt="Bosch logo" style="width: 30%; float: right; padding-left: 2px; margin-top: -1em"/>-->
+<!-- <h4>software developer <br/>@ Bosch.IO</h4>-->
+<!-- <h4 style="padding-top:1em">project lead of Eclipse Ditto</h4>-->
+<!-- <h4 style="padding-top:1em">lead developer of commercial service<br/>"Bosch IoT Things"</h4>-->
+<!-- </div>-->
+<!-- </section>-->
+
+ <section id="agenda" class="new-chapter">
+ <h2>agenda</h2>
+ <br/>
+ <ol>
+<!-- <li><a href="#motivation">Motivation</a></li>-->
+ <li><a href="#twin">Digital Twins</a></li>
+ <li><a href="#ditto">Eclipse Ditto</a></li>
+ <li><a href="#ditto-ttn">Ditto + TTN</a></li>
+ <li><a href="#hands-on">Hands-on</a></li>
+ <li><a href="#wrap-up">Wrap up</a></li>
+ </ol>
+ </section>
+ </section>
+
+ <!-- Section: Motivation -->
+<!-- <section style="clear: both;">-->
+<!-- <section id="motivation" class="new-chapter" data-background="../bg-images/background-cloud-small.jpg"-->
+<!-- data-state="chapter-background">-->
+<!-- <!– background source: http://wallpapercave.com/wp/WkziiJQ.jpg –>-->
+<!-- <h1>Motivation</h1>-->
+<!-- <br/>-->
+<!-- <h2>turn physical devices into services</h2>-->
+<!-- </section>-->
+<!-- <section id="motivation-0" style="clear: both;">-->
+<!-- <h2>IoT</h2>-->
+<!-- <br/>-->
+<!-- <h3>connecting <b>things</b> from various domains to the <b>Internet</b> happens</h3>-->
+<!-- <div class="fragment" style="margin-top: 1em;">-->
+<!-- <ul>-->
+<!-- <li>on devices</li>-->
+<!-- <li>on the edge (e.g. gateways)</li>-->
+<!-- <li>in the back-end (a.k.a. "cloud")</li>-->
+<!-- <li>near the user (apps, uis)</li>-->
+<!-- </ul>-->
+<!-- </div>-->
+<!-- </section>-->
+<!-- <section id="motivation-1" style="clear: both;">-->
+<!-- <h2>IoT solution development</h2>-->
+<!-- <br/>-->
+<!-- <ul style="font-size: 0.9em;">-->
+<!-- <li class="fragment">web and mobile apps need <b>APIs</b> optimized for the web</li>-->
+<!-- <li class="fragment" style="margin-top: 0.5em;">security: <b>control</b> who has <b>access</b> to which aspects</li>-->
+<!-- <li class="fragment" style="margin-top: 0.5em;">choose whether to <b>directly</b> communicate to devices <b>and</b> access <b>last known</b> state</li>-->
+<!-- <li class="fragment" style="margin-top: 0.5em;">integrate with other systems by getting <b>notified</b> about changes/events</li>-->
+<!-- <li class="fragment" style="margin-top: 0.5em;">connect and work with devices at <b>scale</b></li>-->
+<!-- </ul>-->
+<!-- </section>-->
+<!-- <section id="motivation-2" style="clear: both;">-->
+<!-- <h2>sounds complicated?</h2>-->
+<!-- <br/>-->
+<!-- <h3>let's find out if the Digital Twin pattern can help</h3>-->
+<!-- <img src="../../images/ditto.svg" alt="Ditto logo" style="width: 200px">-->
+<!-- </section>-->
+<!-- </section>-->
+
+ <!-- Section: Digital Twins -->
+ <section style="clear: both;">
+ <section id="twin" class="new-chapter" data-background="../bg-images/background-twin-small.jpg"
+ data-state="chapter-background">
+ <!-- background source: https://unsplash.com/search/twin?photo=SmAiLn-nnJg -->
+ <h1>Digital Twins</h1>
+ <br/>
+ <ul>
+ <li class="fragment">digital representation of real physical devices</li>
+ <li class="fragment" style="margin-top: 1em;">act as broker for communicating with assets</li>
+ <li class="fragment" style="margin-top: 1em;">also: representation of processes or services</li>
+ <li class="fragment" style="margin-top: 1em;">applicable for both industrial and consumer-centric IoT scenarios</li>
+ </ul>
+ </section>
+<!-- <section id="twin-1" style="clear: both;">-->
+<!-- <h2>DT - our interpretation</h2>-->
+<!-- <br/>-->
+<!-- <ul>-->
+<!-- <li class="fragment">a pattern for working with <b>things</b> in the IoT</li>-->
+<!-- <li class="fragment" style="margin-top: 0.8em;">provide state <b>persistence</b> and <b>search</b> capabilities</li>-->
+<!-- <li class="fragment" style="margin-top: 0.8em;">access twins always in an <b>authorized</b> way</li>-->
+<!-- <li class="fragment" style="margin-top: 0.8em;">provide APIs - <b>Device as a Service</b></li>-->
+<!-- <li class="fragment" style="margin-top: 0.8em;"><b>normalize</b> device payloads</li>-->
+<!-- </ul>-->
+<!-- </section>-->
+ </section>
+
+ <!-- Section: Ditto -->
+ <section style="clear: both;">
+ <section id="ditto" class="new-chapter" data-background="../bg-images/background-cloud-small.jpg"
+ data-state="chapter-background">
+ <!-- background source: http://wallpapercave.com/wp/WkziiJQ.jpg -->
+ <h1>Eclipse Ditto</h1>
+ <br/>
+ <h2>… where IoT devices and their Digital Twins get together</h2>
+ </section>
+ <section id="ditto-1" style="clear: both;">
+ <h2>in context</h2>
+ <div style="text-align: left; float: left; width: 65%">
+ <img src="../images/ditto-in-action-2020.png" style="width: 90%;padding-top:0.5em" alt="Ditto in action"/>
+ </div>
+ <div style="text-align: left; float: right; width: 35%">
+ <p style="padding-top:3.5em">Ditto as <br/>Digital Twin<br/> "middleware"</p>
+ </div>
+ </section>
+ <section id="ditto-2" style="clear: both;">
+ <h2>turn device data into APIs</h2>
+ <div style="text-align: left; float: left; width: 38%">
+ <pre style="width: 100%; font-size: 0.45em;"><code class="hljs json">{
+ "thingId": "io.foo:car1",
+ "policyId": "io.foo:car1",
+ "attributes": {
+ "manufacturer": "Foo corp",
+ "productionData": {
+ "serialNo": 4711
+ }
+ },
+ "features": {
+ "temperature": {
+ "properties": {
+ "value": 23.42
+ }
+ }
+ }
+}</code></pre>
+ <p style="text-align: center">JSON repr. of a Thing</p>
+ </div>
+ <div style="text-align: left; float: right; width: 60%" class="fragment">
+ <pre style="width: 105%; font-size: 0.45em;"><code class="hljs">GET/PUT/DELETE /api/2/things/io.foo:car1
+ /api/2/things/io.foo:car1/thingId
+ /api/2/things/io.foo:car1/policyId
+ /api/2/things/io.foo:car1/attributes
+ /api/2/things/io.foo:car1/attributes/manufacturer
+ /api/2/things/io.foo:car1/attributes/productionData
+ /api/2/things/io.foo:car1/attributes/productionData/serialNo
+
+
+ /api/2/things/io.foo:car1/features
+ /api/2/things/io.foo:car1/features/temperature
+ /api/2/things/io.foo:car1/features/temperature/properties
+ /api/2/things/io.foo:car1/features/temperature/properties/value
+
+
+
+
+</code></pre>
+ <a href="https://www.eclipse.org/ditto/httpapi-concepts.html#endpoints" style="float: right;">→ docs</a>
+ </div>
+ </section>
+ <section id="ditto-3" style="clear: both;">
+ <h2>persistence of device state</h2>
+ <br/>
+ <div style="text-align: left; float: left; width: 48%">
+ <ul>
+ <li>devices are not always connected to the net</li>
+ <li class="fragment" data-fragment-index="1" style="margin-top: 1em;">applications always need to be able to access their data</li>
+ <li class="fragment" data-fragment-index="2" style="margin-top: 1em;"><b>twin</b> vs. <b>live</b> access on API level</li>
+ </ul>
+ </div>
+ <div class="fragment" data-fragment-index="2" style="text-align: left; float: right; width: 50%">
+ <img src="../../images/pages/protocol/ditto-twin-channel.png" style="width: 110%" alt="Ditto twin channel">
+ <img src="../../images/pages/protocol/ditto-live-channel.png" style="width: 80%;padding-left: 1em" alt="Ditto live channel">
+ </div>
+ </section>
+ <section id="ditto-4" style="clear: both">
+ <h2>authorization</h2>
+ <br/>
+ <div style="text-align: left; float: left; width: 58%">
+ <br/>
+ <ul>
+ <li>Ditto contains a built-in authorization mechanism (<b>Policies</b>)</li>
+ <li class="fragment" style="margin-top: 1em;">every API call is authorized</li>
+ </ul>
+ </div>
+ <div style="text-align: left; float: right; width: 40%">
+ <pre style="width: 110%; font-size: 0.3em;"><code class="hljs">{
+ "policyId": "io.foo:car1-policy",
+ "entries": {
+ "owner": {
+ "subjects": {
+ "nginx:admin": {
+ "type": "nginx basic auth user"
+ }
+ },
+ "resources": {
+ "thing:/": {
+ "grant": ["READ","WRITE"],
+ "revoke": []
+ },
+ "thing:/features/firmware": {
+ "grant": [],
+ "revoke": ["WRITE"]
+ },
+ "policy:/": {
+ "grant": ["READ","WRITE"],
+ "revoke": []
+ }
+ }
+ }
+ }
+ }</code></pre>
+ <a href="https://www.eclipse.org/ditto/basic-auth.html#authorization" style="float: right;">→ docs</a>
+ </div>
+ </section>
+ <section id="ditto-5" style="clear: both;">
+ <h2>search</h2>
+ <br/>
+ <div style="text-align: left; float: left; width: 40%">
+ <img src="../images/meme-dino.jpg" style="width: 80%;" alt="Meme Dino" />
+ <ul style="font-size: 0.7em">
+ <li>you must not</li>
+ <li>Ditto has you covered</li>
+ </ul>
+ </div>
+ <div style="text-align: left; float: right; width: 60%" class="fragment" data-fragment-index="1">
+ <pre style="width: 100%; font-size: 0.45em;"><code class="hljs javascript">GET /api/2/search/things
+ ?filter=like(attributes/manufacturer,"Foo*")</code></pre>
+ <pre style="width: 100%; font-size: 0.45em;" class="fragment" data-fragment-index="2"><code class="hljs javascript">GET /api/2/search/things
+ ?filter=and(
+ exists(attributes/manufacturer),
+ gt(features/temperature/properties/value,23.0)
+ )
+ &namespaces=io.foo
+ &option=sort(-_modified,-attributes/manufacturer)
+ &fields=thingId,attributes/manufacturer,_modified</code></pre>
+ </div>
+ <div class="fragment" data-fragment-index="2">
+ <ul style="font-size: 0.7em">
+ <li>search for arbitrary data with RQL query</li>
+ <li>Ditto again ensures authorization</li>
+ <li>apply field projection over the results</li>
+ <li>don't worry about indexing</li>
+ </ul>
+ <a href="https://www.eclipse.org/ditto/basic-search.html" style="float: right;">→ docs</a>
+ </div>
+ </section>
+ <section id="ditto-6" style="clear: both;">
+ <h2>get notified about changes</h2>
+ <br/>
+ <ul>
+ <li>notification via various channels: WebSocket, SSE, MQTT, AMQP, Kafka, HTTP hook</li>
+ <li class="fragment" style="margin-top: 1em;">server side filtering via RQL (same as in search)</li>
+ </ul>
+ <div class="fragment">
+ <pre style="width: 100%; font-size: 0.45em;margin-top: 1em"><code class="hljs javascript">var ws = new WebSocket("ws://ditto:ditto@localhost:80/ws/2");
+ws.onopen = function(w) {
+ w.send('START-SEND-EVENTS?filter=gt(features/temperature/properties/value,25)');
+};
+ws.onmessage = function(msg) {
+ console.log('received: ' + msg.data);
+};</code></pre>
+ <p style="text-align: left; font-size: 0.7em">example of WebSocket browser API</p>
+ <a href="https://www.eclipse.org/ditto/basic-changenotifications.html" style="float: right;">→ docs</a>
+ </div>
+ </section>
+ <section id="ditto-7" style="clear: both;">
+ <h2>payload normalization</h2>
+ <br/>
+ <div style="text-align: left; float: left; width: 70%">
+ <ul>
+ <li>devices send data in various formats</li>
+ <li class="fragment" style="margin-top: 0.8em;">Ditto provides structured APIs of <b>things</b> (attributes, features)</li>
+ <li class="fragment" style="margin-top: 0.8em;">devices don't need to be aware of Ditto</li>
+ </ul>
+ </div>
+ <div class="fragment">
+ <div style="text-align: left; float: right; width: 30%">
+ <img src="../images/Javascript_badge.svg" style="width: 100%; padding-top: 1em" alt="JavaScript logo">
+ <!-- img source: https://commons.wikimedia.org/wiki/File:Javascript_badge.svg -->
+ </div>
+ <ul style="clear: both; width: 100%">
+ <li style="margin-top: 1em;">incoming and outgoing data can be transformed</li>
+ </ul>
+ </div>
+ </section>
+ <section id="ditto-8" style="clear: both;">
+ <h2>nonfunctional</h2>
+ <br/>
+ <div style="text-align: left; float: left; width: 46%">
+ <img src="../../images/pages/architecture/context-overview.png" alt="Ditto context overview" />
+ </div>
+ <div style="text-align: left; float: right; width: 54%">
+ <ul style="font-size: 0.8em">
+ <li >modular architecture of Ditto services</li>
+ <li style="margin-top: 0.8em;">horizontal scalability of each Ditto service</li>
+ <li style="margin-top: 0.8em;">runtime dependency to MongoDB</li>
+ <li style="margin-top: 0.8em;">included monitoring (JVM metrics, roundtrips, MongoDB)</li>
+ <li style="margin-top: 0.8em;">codebase written in: Java</li>
+ </ul>
+ </div>
+ </section>
+ </section>
+
+ <!-- Section: Ditto + LoRaWAN -->
+ <section style="clear: both;">
+ <section id="ditto-ttn" class="new-chapter" data-background="../bg-images/background-cloud-small.jpg"
+ data-state="chapter-background">
+ <!-- background source: http://wallpapercave.com/wp/WkziiJQ.jpg -->
+ <h1>Eclipse Ditto +</h1>
+ <img src="../images/ttn-logo.png" alt="The Things Network logo" style="width: 40%"/>
+ </section>
+ <section id="ditto-ttn-1" style="clear: both;">
+ <h2>benefit from each other</h2>
+ <br/>
+ <ul>
+ <li>TTN solving low cost, wide range connectivity of devices</li>
+ <li class="fragment" data-fragment-index="1" style="margin-top: 0.5em;">Eclipse Ditto providing APIs for IoT (backend-, web-, mobile-) applications</li>
+ <li class="fragment" data-fragment-index="2" style="margin-top: 0.5em;">both provide free/community variants</li>
+ <li class="fragment" data-fragment-index="2" style="margin-top: 0.5em;">both provide commercial services</li>
+ </ul>
+ </section>
+ <section id="ditto-ttn-2" style="clear: both;">
+ <h2>integration variants</h2>
+ <br/>
+ <div style="text-align: center; float: left; width: 48%">
+ <h4>using TTN's HTTP integration</h4>
+ <img src="../images/ttn-hono-ditto.png" alt="TTN via Hono to Ditto" style="width: 70%"/>
+<!-- <ul class="fragment" style="font-size: 0.7em">-->
+<!-- <li>publish messages via HTTP to <a href="https://eclipse.org/hono" alt="Hono">Eclipse Hono</a> (a sister project in Eclipse IoT for "connecting large numbers of IoT devices to a back end")</li>-->
+<!-- <li>Ditto consumes messages via AMQP 1.0 from Hono</li>-->
+<!-- </ul>-->
+ </div>
+ <div class="fragment" style="text-align: center; float: right; width: 48%">
+ <h4>using TTN's MQTT broker</h4>
+ <img src="../images/ttn-ditto-via-mqtt.png" alt="TTN via MQTT to Ditto" style="width: 70%"/>
+<!-- <ul class="fragment" style="font-size: 0.7em">-->
+<!-- <li>add connection inside Eclipse Ditto to the TTN MQTT broker</li>-->
+<!-- <li>Ditto consumes messages via MQTT 3.1.1 directly from TTN</li>-->
+<!-- </ul>-->
+ <h4 class="fragment"><b>* used now</b> for the hands-on part</h4>
+ </div>
+ </section>
+ </section>
+
+ <!-- Section: Hands-on -->
+ <section style="clear: both;">
+ <section id="hands-on" class="new-chapter" data-background="../bg-images/background-demo-small.jpg" data-state="chapter-background">
+ <h1>hands-on time!</h1>
+ <br/>
+ <h3><a href="https://eclipse.org/ditto/2020-04-16-connecting-to-ttn-via-mqtt.html">Step-by-step blogpost</a></h3>
+ </section>
+ </section>
+
+ <!-- Section: Wrap up -->
+ <section style="clear: both;">
+ <section id="wrap-up" style="clear: both;">
+ <h1>Wrap up</h1>
+ <br/>
+ <ul>
+ <li>Digital Twins as pattern for simplifying IoT solution development</li>
+ <li style="margin-top: 1em;">Mission: provide Device-as-a-Service</li>
+ <li style="margin-top: 1em;">Eclipse Ditto as OpenSource framework for Digital Twins</li>
+ </ul>
+ </section>
+
+<!-- <section id="bosch-iot-things" style="clear: both;">-->
+<!-- <h2>Bosch IoT Things</h2>-->
+<!-- <br/>-->
+<!-- <div style="text-align: left; float: left; width: 31%; font-size: 0.6em">-->
+<!-- <img src="../images/bosch-iot-things-2020.png" style="width: 100%" alt="Bosch IoT Things" />-->
+<!-- <h4>freemium model</h4>-->
+<!-- <h4>+operated 24/7</h4>-->
+<!-- <h4>+support</h4>-->
+<!-- <h4>+management UI</h4>-->
+<!-- </div>-->
+<!-- <div style="text-align: left; float: right; width: 68%">-->
+<!-- <ul>-->
+<!-- <li class="fragment">commercial cloud service offering of Eclipse Ditto</li>-->
+<!-- <li class="fragment" style="margin-top: 1em;">part of the <a href="https://www.bosch-iot-suite.com">Bosch IoT Suite</a></li>-->
+<!-- <li class="fragment" style="margin-top: 1em;">same team works on Ditto and commercialization</li>-->
+<!-- <li class="fragment" style="margin-top: 1em;">evaluate Ditto by using free plan</li>-->
+<!-- </ul>-->
+<!-- </div>-->
+<!-- </section>-->
+ </section>
+
+ <!-- Section: Questions and Answers -->
+ <section style="clear: both;">
+ <section id="q-a" class="new-chapter" data-background="../bg-images/background-conclusion-small.jpg"
+ data-state="chapter-background">
+ <br/>
+ <h3>thanks to The Things Network for organising this virtual conference</h3>
+ <br/>
+ <p>Links:</p>
+ <ul>
+ <li><a target="_blank" href="https://eclipse.org/ditto">Ditto website and documentation</a></li>
+ <li><a target="_blank" href="https://github.org/eclipse/ditto">GitHub</a> - please give us a star ;)</li>
+ <li><a target="_blank" href="https://gitter.im/eclipse/ditto">Chatroom to ask more questions</a></li>
+ <li><a target="_blank" href="https://developer.bosch-iot-suite.com/service/things/">Commercial offering incl. free plan</a></li>
+ </ul>
+ </section>
+ </section>
+ </div>
+
+</div>
+
+<div class="footer">
+ Copyright ©2020
+ <a href="https://www.bosch.io" target="_blank">Bosch.IO GmbH</a> All rights reserved. |
+ <a href="https://www.eclipse.org/ditto/intro-overview.html" target="_blank">Documentation</a> |
+ <a href="https://github.com/eclipse/ditto" target="_blank">GitHub</a> |
+ <a href="https://ditto.eclipse.org" target="_blank">Sandbox</a>
+</div>
+
+<script src="https://cdnjs.cloudflare.com/ajax/libs/reveal.js/3.6.0/lib/js/head.min.js"></script>
+<script src="https://cdnjs.cloudflare.com/ajax/libs/reveal.js/3.6.0/js/reveal.min.js"></script>
+
+<script>
+ function getParameterByName(name, url) {
+ if (!url) {
+ url = window.location.href;
+ }
+ name = name.replace(/[\[\]]/g, "\\$&");
+ var regex = new RegExp("[?&]" + name + "(=([^&#]*)|&|#|$)"),
+ results = regex.exec(url);
+ if (!results) {
+ return null;
+ }
+ if (!results[2]) {
+ return '';
+ }
+ return decodeURIComponent(results[2].replace(/\+/g, " "));
+ }
+
+ // More info https://github.com/hakimel/reveal.js#configuration
+ Reveal.initialize({
+ controls: true,
+ progress: true,
+ history: true,
+ center: true,
+ fragments: getParameterByName('fragments') === '', // only use "fragments" feature if queryParam 'fragments' is present
+ slideNumber: 'h.v',
+
+ transition: 'convex', // none/fade/cube/slide/convex/concave/zoom
+
+ // More info https://github.com/hakimel/reveal.js#dependencies
+ dependencies: [
+ {
+ src: 'https://cdnjs.cloudflare.com/ajax/libs/reveal.js/3.6.0/lib/js/classList.js',
+ condition: function () {
+ return !document.body.classList;
+ }
+ },
+ {
+ src: 'https://cdnjs.cloudflare.com/ajax/libs/reveal.js/3.6.0/plugin/markdown/marked.js',
+ condition: function () {
+ return !!document.querySelector('[data-markdown]');
+ }
+ },
+ {
+ src: 'https://cdnjs.cloudflare.com/ajax/libs/reveal.js/3.6.0/plugin/markdown/markdown.min.js',
+ condition: function () {
+ return !!document.querySelector('[data-markdown]');
+ }
+ },
+ {
+ src: 'https://cdnjs.cloudflare.com/ajax/libs/reveal.js/3.6.0/plugin/highlight/highlight.min.js',
+ async: true,
+ callback: function () {
+ hljs.initHighlightingOnLoad();
+ }
+ },
+ {
+ src: 'https://cdnjs.cloudflare.com/ajax/libs/reveal.js/3.6.0/plugin/zoom-js/zoom.min.js',
+ async: true
+ },
+ {
+ src: 'https://cdnjs.cloudflare.com/ajax/libs/reveal.js/3.6.0/plugin/notes/notes.min.js',
+ async: true
+ }
+ ],
+ keyboard: { // for hama remote presenter:
+ 38: 'next',
+ 40: 'prev'
+ }
+ });
+
+</script>
+
+<script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/2.2.4/jquery.min.js"></script>
+<script type="text/javascript">
+ // 3. On Reveal.js ready event, copy header/footer <div> into each `.slide-background` <div>
+ var header = $('#header').html();
+ if (window.location.search.match(/print-pdf/gi)) {
+ Reveal.addEventListener('ready', function (event) {
+ $('.slide-background').append(header);
+ });
+ }
+ else {
+ $('div.reveal').append(header);
+ }
+</script>
+
+</body>
+</html>
diff --git a/1.0/slides/images/Javascript_badge.svg b/1.0/slides/images/Javascript_badge.svg
new file mode 100755
index 0000000..1774518
--- /dev/null
+++ b/1.0/slides/images/Javascript_badge.svg
@@ -0,0 +1,149 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+ xmlns:dc="http://purl.org/dc/elements/1.1/"
+ xmlns:cc="http://creativecommons.org/ns#"
+ xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+ xmlns="http://www.w3.org/2000/svg"
+ xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+ xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+ width="145.75"
+ height="157.82767"
+ id="svg2"
+ version="1.1"
+ inkscape:version="0.48.4 r9939"
+ sodipodi:docname="javascript.svg">
+ <defs
+ id="defs4" />
+ <sodipodi:namedview
+ id="base"
+ pagecolor="#ffffff"
+ bordercolor="#666666"
+ borderopacity="1.0"
+ inkscape:pageopacity="0.0"
+ inkscape:pageshadow="2"
+ inkscape:zoom="0.77995601"
+ inkscape:cx="50.16802"
+ inkscape:cy="19.624571"
+ inkscape:document-units="px"
+ inkscape:current-layer="layer1"
+ showgrid="false"
+ inkscape:window-width="1026"
+ inkscape:window-height="764"
+ inkscape:window-x="220"
+ inkscape:window-y="220"
+ inkscape:window-maximized="0"
+ fit-margin-top="0"
+ fit-margin-left="0"
+ fit-margin-right="0"
+ fit-margin-bottom="0" />
+ <metadata
+ id="metadata7">
+ <rdf:RDF>
+ <cc:Work
+ rdf:about="">
+ <dc:format>image/svg+xml</dc:format>
+ <dc:type
+ rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+ <dc:title />
+ </cc:Work>
+ </rdf:RDF>
+ </metadata>
+ <g
+ inkscape:label="Layer 1"
+ inkscape:groupmode="layer"
+ id="layer1"
+ transform="translate(-326.59295,-168.33349)">
+ <g
+ id="g8487"
+ transform="translate(-202.57553,-38.463711)">
+ <g
+ transform="matrix(1.25,0,0,1.25,-2.5065195,174.1722)"
+ id="g3652">
+ <path
+ style="opacity:0.85;fill:#101010"
+ inkscape:connector-curvature="0"
+ d="m 512.87,26.15 c 1.4,-0.02 2.81,-0.04 4.22,-0.05 0.02,0.78 0.05,2.33 0.07,3.11 -1.44,0 -2.88,-0.01 -4.31,-0.01 0,-0.76 0.02,-2.28 0.02,-3.05 z"
+ id="path3654" />
+ </g>
+ <path
+ id="path3664"
+ d="m 531.79348,207.6597 c 3.2125,0.025 6.4375,0.0375 9.675,0.05 -0.275,5.75 0.85,11.725 -0.775,17.325 -2.1,4.025 -7.325,3.2375 -11.0875,3.3125 -0.15,-1.275 -0.3,-2.55 -0.4375,-3.825 2.1625,-0.175 4.5125,0.25 6.5,-0.8625 1.2875,-3.9875 0.7125,-8.25 0.3875,-12.35 -1.1,0.025 -3.2875,0.05 -4.3875,0.0625 0.0375,-0.925 0.0875,-2.7875 0.125,-3.7125 z"
+ inkscape:connector-curvature="0"
+ style="fill:#131313" />
+ <path
+ id="path3666"
+ d="m 596.15598,209.2347 c 3.7875,-2.925 8.7625,-1.725 12.975,-0.5875 -0.0125,1.1125 -0.025,3.3375 -0.025,4.45 -3.2625,-1.3125 -9.4625,-4.175 -10.2875,1.225 3.0875,0.9375 6.35,1.4875 9.15,3.1625 2.975,2.425 2.1375,7.9375 -1.2875,9.6 -3.9,2.3125 -8.525,1.05 -12.6375,0.2125 -0.2375,-1.7125 -0.475,-3.4125 -0.6875,-5.125 3.4625,1.525 10.475,5.1375 11.5125,-0.7 -3.475,-1.3125 -7.8,-1.5 -10.325,-4.5 -1.1125,-2.55 -0.925,-6.1 1.6125,-7.7375 z"
+ inkscape:connector-curvature="0"
+ style="fill:#131313" />
+ <path
+ id="path3668"
+ d="m 665.26848,208.3722 c 1.4625,0 2.9375,0 4.425,0 0.0375,1.4125 0.0875,2.825 0.15,4.2375 1.125,0.0125 3.3875,0.0375 4.525,0.05 0.025,0.8625 0.0625,2.575 0.0875,3.425 -1.15,-0.0125 -3.45,-0.0375 -4.6,-0.0625 0.0625,2.8625 -0.675,5.9875 0.7625,8.625 1.075,0.1125 3.225,0.325 4.3,0.4375 -0.1125,5.2625 -6.1125,2.875 -9.2875,2.05 -0.2875,-3.2125 -0.425,-6.425 -0.425,-9.65 -0.8125,-1.1375 -1.625,-2.2875 -2.425,-3.425 0.6125,-0.5625 1.8375,-1.6875 2.45,-2.25 0.0125,-0.8625 0.025,-2.5875 0.0375,-3.4375 z"
+ inkscape:connector-curvature="0"
+ style="fill:#131313" />
+ <path
+ id="path3670"
+ d="m 545.36848,212.7722 c 4.075,-0.2125 9.775,-1.725 12.3375,2.4875 0.9125,4.175 0.3375,8.5125 0.475,12.7625 -1.825,-0.1625 -3.65,-0.3375 -5.4625,-0.5 -2.075,0.175 -4.5125,1.7125 -6.425,0.3375 -3.175,-1.525 -3.225,-7.15 0.1125,-8.5125 2.425,-1 5.075,-1.175 7.6125,-1.775 -2.4125,-2.5 -5.8375,-1.55 -8.875,-1.225 0.0625,-0.9 0.175,-2.6875 0.225,-3.575 m 3.975,8.5875 c -0.1375,1.2125 -0.2625,2.425 -0.375,3.65 1.3875,-0.075 2.775,-0.1375 4.175,-0.2125 0.1,-1.3125 0.2125,-2.625 0.325,-3.9375 -1.3875,0.1625 -2.7625,0.3375 -4.125,0.5 z"
+ inkscape:connector-curvature="0"
+ style="fill:#131313" />
+ <path
+ id="path3672"
+ d="m 560.04348,212.3347 c 1.2,0.2375 3.6125,0.7125 4.8125,0.95 1.2625,2.9 2.125,5.95 3.35,8.875 1.025,-3.125 1.975,-6.2875 2.9,-9.45 1.2,-0.025 3.6125,-0.0625 4.8125,-0.0875 -1.7,5.3625 -3.6,10.6625 -5.725,15.8875 -1.65,-0.2125 -3.275,-0.5625 -4.85,-1.025 -2.275,-4.85 -3.775,-10.025 -5.3,-15.15 z"
+ inkscape:connector-curvature="0"
+ style="fill:#131313" />
+ <path
+ id="path3674"
+ d="m 577.46848,216.3222 c 0.35,-1.1875 0.75,-2.375 1.1875,-3.5375 3.875,-0.5625 9.125,-1.3875 11.7875,2.2375 0.9125,4.325 0.35,8.8 0.4375,13.1875 -1.8375,-0.25 -3.6625,-0.5 -5.4875,-0.75 -3.275,1.7375 -8.7375,1.1125 -8.6625,-3.5 -0.625,-5.475 6.2125,-5.55 9.925,-6.275 -2.2375,-3 -6.1125,-1.4125 -9.1875,-1.3625 m 4.525,5.15 c -0.1375,1.125 -0.2625,2.2625 -0.3875,3.3875 1.375,0.0375 2.75,0.075 4.1375,0.1 0.125,-1.3875 0.25,-2.7625 0.375,-4.15 -1.375,0.2125 -2.75,0.4375 -4.125,0.6625 z"
+ inkscape:connector-curvature="0"
+ style="fill:#131313" />
+ <path
+ id="path3676"
+ d="m 610.90598,220.4097 c -0.3875,-6.8 8.2625,-10.3625 13.4375,-6.7375 0.125,0.9625 0.3625,2.9 0.475,3.8625 -2.375,-0.75 -4.8125,-2.45 -7.3625,-1.3 -2.7,2.575 -2.1375,9.1125 2.4375,8.725 1.2625,-0.4 3.775,-1.2 5.0375,-1.6 -0.225,1.075 -0.6625,3.225 -0.875,4.2875 -5.4125,2.55 -13.575,-0.4625 -13.15,-7.2375 z"
+ inkscape:connector-curvature="0"
+ style="fill:#131313" />
+ <path
+ id="path3678"
+ d="m 626.89348,212.2847 c 1.875,0.5 3.7875,1 5.675,1.5375 1.4125,-0.5125 2.8375,-1.0125 4.275,-1.525 0.0625,1.2 0.2125,3.6 0.2875,4.8 -1.8,0.0875 -3.6,0.175 -5.375,0.2625 -0.125,3.5875 -0.1625,7.1625 -0.1875,10.75 -1.175,0.0125 -3.5375,0.025 -4.7125,0.0375 -0.0625,-5.2875 -0.075,-10.575 0.0375,-15.8625 z"
+ inkscape:connector-curvature="0"
+ style="fill:#131313" />
+ <path
+ id="path3680"
+ d="m 647.21848,212.6222 c 3.45,0.775 6.925,0.5375 10.3625,-0.15 5.3875,1.1125 5.5125,8.75 3.4625,12.75 -1.7,3.45 -5.8625,3.125 -9.075,2.95 0.025,1.825 0.05,3.6375 0.075,5.4625 -1.2,-0.0125 -3.625,-0.0375 -4.8375,-0.0625 0,-6.975 -0.0125,-13.9625 0.0125,-20.95 m 4.875,3.675 c -0.05,2.9125 -0.075,5.8375 -0.05,8.75 1.55,-0.425 3.55,-0.125 4.725,-1.4625 0.875,-2.375 0.1875,-4.9375 0.0125,-7.3875 -1.5625,0.025 -3.125,0.0625 -4.6875,0.1 z"
+ inkscape:connector-curvature="0"
+ style="fill:#131313" />
+ <g
+ transform="matrix(1.25,0,0,1.25,-2.5065195,174.1722)"
+ id="g3688">
+ <path
+ style="fill:#131313"
+ inkscape:connector-curvature="0"
+ d="m 513.23,30.79 c 0.89,0 2.67,0 3.55,0 0.06,4.13 0.06,8.25 0,12.38 -0.89,0 -2.66,0 -3.55,0 -0.07,-4.12 -0.07,-8.25 0,-12.38 z"
+ id="path3690" />
+ </g>
+ <g
+ transform="matrix(1.25,0,0,1.25,-2.5065195,174.1722)"
+ id="g3768">
+ <path
+ style="fill:#d6ba32"
+ inkscape:connector-curvature="0"
+ d="m 439.03,51.2 c 9.97,-0.42 19.96,0.12 29.94,-0.05 11.01,-0.35 22.01,-0.06 33.03,-0.02 8.74,0.02 17.48,-0.04 26.22,0.03 -2.75,30.33 -5.52,60.66 -8.07,91.01 -11.71,3.33 -23.43,6.61 -35.14,9.92 -1.5,0.62 -3.04,0.04 -4.48,-0.35 -11.13,-3.2 -22.26,-6.37 -33.41,-9.45 -2.9,-30.34 -5.63,-60.71 -8.09,-91.09 m 44.78,7.91 c -0.41,14.96 -0.06,29.92 -0.18,44.88 0.11,13.68 -0.2,27.37 0.16,41.05 9.84,-2.32 19.55,-5.17 29.26,-7.98 2.44,-25.97 4.82,-51.94 6.86,-77.94 -12.03,-0.12 -24.07,0.02 -36.1,-0.01 m -12.52,58.42 c -5.78,-1.58 -11.49,-3.4 -17.35,-4.65 -0.17,3.48 -0.11,6.96 0.29,10.42 8.58,2.09 16.98,4.84 25.57,6.89 0.06,-19.81 -0.03,-39.63 0.04,-59.44 -2.8,-0.07 -5.6,-0.11 -8.4,-0.17 -0.32,15.64 -0.02,31.3 -0.15,46.95 z"
+ id="path3770" />
+ </g>
+ <g
+ transform="matrix(1.25,0,0,1.25,-2.5065195,174.1722)"
+ id="g3796">
+ <path
+ style="fill:#ffda3e"
+ inkscape:connector-curvature="0"
+ d="m 483.81,59.11 c 12.03,0.03 24.07,-0.11 36.1,0.01 -2.04,26 -4.42,51.97 -6.86,77.94 -9.71,2.81 -19.42,5.66 -29.26,7.98 -0.36,-13.68 -0.05,-27.37 -0.16,-41.05 0.12,-14.96 -0.23,-29.92 0.18,-44.88 m 3.37,11.63 c 0.04,12.88 0.05,25.77 0,38.65 5.88,-0.95 11.74,-2.04 17.6,-3.11 -0.09,3 -0.21,6 -0.34,9 -5.71,1.52 -11.41,3.09 -17.15,4.5 -0.09,3.46 -0.1,6.92 -0.07,10.39 7.23,-1.62 14.35,-3.66 21.53,-5.47 0.9,-0.42 2.63,-0.37 2.55,-1.78 0.87,-9.26 1.41,-18.56 2.25,-27.84 -5.95,0.49 -11.84,1.49 -17.79,1.9 -0.05,-5.26 -0.06,-10.52 0.02,-15.78 6.26,0 12.51,0 18.77,0.01 0.4,-3.51 0.75,-7.03 1.02,-10.55 -9.46,0.04 -18.93,-0.09 -28.39,0.08 z"
+ id="path3798" />
+ </g>
+ <path
+ id="path3806"
+ d="m 586.60598,321.0847 c 0.1625,-19.5625 -0.2125,-39.1375 0.1875,-58.6875 3.5,0.075 7,0.125 10.5,0.2125 -0.0875,24.7625 0.025,49.5375 -0.05,74.3 -10.7375,-2.5625 -21.2375,-6 -31.9625,-8.6125 -0.5,-4.325 -0.575,-8.675 -0.3625,-13.025 7.325,1.5625 14.4625,3.8375 21.6875,5.8125 z"
+ inkscape:connector-curvature="0"
+ style="fill:#ebebeb" />
+ </g>
+ </g>
+</svg>
diff --git a/1.0/slides/images/bosch-iot-things-2020.png b/1.0/slides/images/bosch-iot-things-2020.png
new file mode 100755
index 0000000..3ce43bf
--- /dev/null
+++ b/1.0/slides/images/bosch-iot-things-2020.png
Binary files differ
diff --git a/1.0/slides/images/ditto-in-action-2020.png b/1.0/slides/images/ditto-in-action-2020.png
new file mode 100755
index 0000000..b02de70
--- /dev/null
+++ b/1.0/slides/images/ditto-in-action-2020.png
Binary files differ
diff --git a/1.0/slides/images/ttn-ditto-via-mqtt.png b/1.0/slides/images/ttn-ditto-via-mqtt.png
new file mode 100755
index 0000000..1918ed7
--- /dev/null
+++ b/1.0/slides/images/ttn-ditto-via-mqtt.png
Binary files differ
diff --git a/1.0/slides/images/ttn-hono-ditto.png b/1.0/slides/images/ttn-hono-ditto.png
new file mode 100755
index 0000000..914c5a8
--- /dev/null
+++ b/1.0/slides/images/ttn-hono-ditto.png
Binary files differ
diff --git a/1.0/slides/images/ttn-logo.png b/1.0/slides/images/ttn-logo.png
new file mode 100755
index 0000000..37a90d4
--- /dev/null
+++ b/1.0/slides/images/ttn-logo.png
Binary files differ
diff --git a/1.0/tag_architecture.html b/1.0/tag_architecture.html
index 9e0d243..8d6e146 100644
--- a/1.0/tag_architecture.html
+++ b/1.0/tag_architecture.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1344,6 +1565,14 @@
+
+
+
+
+
+
+
+
@@ -1378,6 +1607,8 @@
+
+
@@ -1468,6 +1699,12 @@
+
+
+
+
+
+
@@ -1496,10 +1733,6 @@
-
-
-
-
@@ -1638,14 +1871,84 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
@@ -1712,6 +2015,10 @@
+
+
+
+
@@ -1912,6 +2219,16 @@
+
+
+
+
+
+
+
+
+
+
</tbody>
</table>
@@ -1934,7 +2251,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/tag_blog.html b/1.0/tag_blog.html
index f506d3e..c9c3b60 100644
--- a/1.0/tag_blog.html
+++ b/1.0/tag_blog.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1302,6 +1523,14 @@
+
+
+
+
+
+
+
+
@@ -1336,6 +1565,8 @@
+
+
@@ -1426,6 +1657,12 @@
+
+
+
+
+
+
@@ -1454,10 +1691,6 @@
-
-
-
-
@@ -1596,14 +1829,84 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
@@ -1670,6 +1973,10 @@
+
+
+
+
@@ -1761,6 +2068,28 @@
+ <tr><td><a href="2020-04-29-release-announcement-110.html">Announcing Eclipse Ditto Release 1.1.0</a></td>
+ <td><span class="label label-primary">Post</span></td>
+ <td> Today, approximately 4 months after Eclipse Ditto’s 1.0.0 release, the team is happy to announce the first minor (feature) update of Ditto 1.0: Eclipse Ditto 1.1.0 The Ditto team was quite busy, 1.1.0 focuses on the following areas: Management of Policies via Ditto Protocol... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="2020-04-16-connecting-to-ttn-via-mqtt.html">Digital twins of devices connected via LoRaWAN to TTN</a></td>
+ <td><span class="label label-primary">Post</span></td>
+ <td> A workshop of the 2020 The Things Virtual Conference on April 16th 2020 is/was about how to connect Eclipse Ditto to “The Things Network” via TTN’s MQTT broker in order to automatically update digital twins of devices connected via LoRaWAN... </td>
+ </tr>
+
+
+
+
+
+
+
+
<tr><td><a href="2019-12-12-release-announcement-100.html">Announcing Eclipse Ditto Release 1.0.0</a></td>
<td><span class="label label-primary">Post</span></td>
<td> Today the Eclipse Ditto is thrilled to announce the availability of Eclipse Ditto’s first major release 1.0.0. Maturity The initial code contribution was done in October 2017, 2 years later and 2 releases (0.8.0 and 0.9.0) later, we think its time to graduate from the Eclipse... </td>
@@ -1937,7 +2266,7 @@
<tr><td><a href="2018-05-02-connecting-ditto-hono.html">Connecting Eclipse Ditto to Eclipse Hono</a></td>
<td><span class="label label-primary">Post</span></td>
- <td> With the recently released Ditto milestone 0.3.0-M1 the connectivity to AMQP 1.0 endpoints can now be established in a durable and stable way (including failovers, etc.). That means Ditto now is ready to be connected to Eclipse Hono’s “northbound” API which is provided via AMQP 1.0.... </td>
+ <td> Warning: This guide does no longer work with the latest (1.x) versions of Ditto + Hono. Please take a look and make use of the Eclipse IoT Packages “cloud2edge” package in order to setup and automatically connect Ditto + Hono. With the recently... </td>
</tr>
@@ -2048,7 +2377,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/tag_client_sdk.html b/1.0/tag_client_sdk.html
index b665cb8..64f0754 100644
--- a/1.0/tag_client_sdk.html
+++ b/1.0/tag_client_sdk.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1302,6 +1523,10 @@
+
+
+
+
@@ -1346,6 +1571,12 @@
+
+
+
+
+
+
@@ -1468,6 +1699,12 @@
+
+
+
+
+
+
@@ -1498,10 +1735,6 @@
-
-
-
-
@@ -1634,6 +1867,76 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
@@ -1746,6 +2049,10 @@
+
+
+
+
@@ -1898,6 +2205,16 @@
+
+
+
+
+
+
+
+
+
+
</tbody>
</table>
@@ -1920,7 +2237,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/tag_connectivity.html b/1.0/tag_connectivity.html
index a191ee7..4fe516a 100644
--- a/1.0/tag_connectivity.html
+++ b/1.0/tag_connectivity.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1308,6 +1529,10 @@
+
+
+
+
@@ -1339,6 +1564,10 @@
+
+
+
+
<tr><td><a href="basic-placeholders.html">Placeholders</a></td>
<td><span class="label label-default">Page</span></td>
@@ -1354,6 +1583,8 @@
+
+
@@ -1511,6 +1742,18 @@
+
+
+
+ <tr><td><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Consume messages from MQTT 5 brokers via sources and send messages to MQTT 5 brokers via targets. Content-type When MQTT messages are sent in Ditto Protocol, the payload should be UTF-8 encoded strings. If messages which are not in Ditto Protocol should be processed, a... </td>
+ </tr>
+
+
+
+
+
<tr><td><a href="connectivity-tls-certificates.html">Certificates for Transport Layer Security</a></td>
<td><span class="label label-default">Page</span></td>
@@ -1548,10 +1791,6 @@
-
-
-
-
@@ -1684,6 +1923,76 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
@@ -1802,6 +2111,10 @@
+
+
+
+
@@ -1850,6 +2163,22 @@
+
+ <tr><td><a href="2020-04-16-connecting-to-ttn-via-mqtt.html">Digital twins of devices connected via LoRaWAN to TTN</a></td>
+ <td><span class="label label-primary">Post</span></td>
+ <td> A workshop of the 2020 The Things Virtual Conference on April 16th 2020 is/was about how to connect Eclipse Ditto to “The Things Network” via TTN’s MQTT broker in order to automatically update digital twins of devices connected via LoRaWAN... </td>
+ </tr>
+
+
+
+
+
+
+
+
+
+
+
@@ -1927,7 +2256,7 @@
<tr><td><a href="2018-05-02-connecting-ditto-hono.html">Connecting Eclipse Ditto to Eclipse Hono</a></td>
<td><span class="label label-primary">Post</span></td>
- <td> With the recently released Ditto milestone 0.3.0-M1 the connectivity to AMQP 1.0 endpoints can now be established in a durable and stable way (including failovers, etc.). That means Ditto now is ready to be connected to Eclipse Hono’s “northbound” API which is provided via AMQP 1.0.... </td>
+ <td> Warning: This guide does no longer work with the latest (1.x) versions of Ditto + Hono. Please take a look and make use of the Eclipse IoT Packages “cloud2edge” package in order to setup and automatically connect Ditto + Hono. With the recently... </td>
</tr>
@@ -1994,7 +2323,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/tag_getting_started.html b/1.0/tag_getting_started.html
index bdf01b8..61626ca 100644
--- a/1.0/tag_getting_started.html
+++ b/1.0/tag_getting_started.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1302,6 +1523,10 @@
+
+
+
+
@@ -1346,6 +1571,12 @@
+
+
+
+
+
+
@@ -1440,6 +1671,12 @@
+
+
+
+
+
+
@@ -1482,10 +1719,6 @@
-
-
-
-
@@ -1512,7 +1745,7 @@
<tr><td><a href="installation-building.html">Building Ditto</a></td>
<td><span class="label label-default">Page</span></td>
- <td> Building with Apache Maven In order to build Ditto with Maven, you’ll need: JDK 8 >= 1.8.0_92 (due to a bug in older versions of the JDK you’ll get a compile error), Apache Maven 3.x installed, a running Docker daemon (at least version 18.06 CE). <div class="language-bash... </td>
+ <td> Building with Apache Maven In order to build Ditto with Maven, you’ll need: JDK 11 >= 1.0.5, Apache Maven 3.x installed, a running Docker daemon (at least version 18.06 CE). mvn clean install cd services sh build-images.sh Building with Docker... </td>
</tr>
@@ -1648,6 +1881,76 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
@@ -1760,6 +2063,10 @@
+
+
+
+
@@ -1912,6 +2219,16 @@
+
+
+
+
+
+
+
+
+
+
</tbody>
</table>
@@ -1934,7 +2251,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/tag_http.html b/1.0/tag_http.html
index 990d41d..d2fb5e6 100644
--- a/1.0/tag_http.html
+++ b/1.0/tag_http.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1302,6 +1523,10 @@
+
+
+
+
@@ -1346,6 +1571,12 @@
+
+
+
+
+
+
@@ -1440,6 +1671,12 @@
+
+
+
+
+
+
@@ -1460,7 +1697,7 @@
<tr><td><a href="httpapi-concepts.html">HTTP API concepts</a></td>
<td><span class="label label-default">Page</span></td>
- <td> Ditto’s HTTP API follows some concepts which are documented on this page. The entry point into the HTTP API is: http://localhost:8080/api/<apiVersion> API versioning Ditto’s HTTP API is versioned in the URL: /api/<apiVersion>. Currently Ditto distinguishes between API version 1 and API version... </td>
+ <td> Ditto’s HTTP API follows some concepts which are documented on this page. The entry point into the HTTP API is: http://localhost:8080/api/<apiVersion> API versioning Ditto’s HTTP API is versioned in the URL: /api/<apiVersion>. Currently Ditto distinguishes between deprecated API version 1 and API... </td>
</tr>
@@ -1487,22 +1724,6 @@
-
- <tr><td><a href="httpapi-postman.html">HTTP API Run in Postman</a></td>
- <td><span class="label label-default">Page</span></td>
- <td> Use Postman and import the Ditto Postman collection which can be downloaded here:
-
- Ditto Postman collection
- Ditto Postman environment for sandbox
-
-
- </td>
- </tr>
-
-
-
-
-
@@ -1534,7 +1755,7 @@
<tr><td><a href="httpapi-sse.html">HTTP API server sent events (SSE)</a></td>
<td><span class="label label-default">Page</span></td>
- <td> HTML5 SSEs may be used in order to get notified when the state of digital twins change. This is the second mechanism of Ditto in order to get change... </td>
+ <td> Server-Sent Events (SSEs) can be used to get notified when the state of digital twins change, and to receive a search results stream. Server-Sent Events Server-Sent Events are... </td>
</tr>
@@ -1654,6 +1875,76 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
@@ -1766,6 +2057,10 @@
+
+
+
+
@@ -1918,6 +2213,16 @@
+
+
+
+
+
+
+
+
+
+
</tbody>
</table>
@@ -1940,7 +2245,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/tag_installation.html b/1.0/tag_installation.html
index 9584840..89a1f2a 100644
--- a/1.0/tag_installation.html
+++ b/1.0/tag_installation.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1302,6 +1523,10 @@
+
+
+
+
@@ -1346,6 +1571,12 @@
+
+
+
+
+
+
@@ -1440,6 +1671,12 @@
+
+
+
+
+
+
@@ -1470,10 +1707,6 @@
-
-
-
-
@@ -1502,7 +1735,7 @@
<tr><td><a href="installation-building.html">Building Ditto</a></td>
<td><span class="label label-default">Page</span></td>
- <td> Building with Apache Maven In order to build Ditto with Maven, you’ll need: JDK 8 >= 1.8.0_92 (due to a bug in older versions of the JDK you’ll get a compile error), Apache Maven 3.x installed, a running Docker daemon (at least version 18.06 CE). <div class="language-bash... </td>
+ <td> Building with Apache Maven In order to build Ditto with Maven, you’ll need: JDK 11 >= 1.0.5, Apache Maven 3.x installed, a running Docker daemon (at least version 18.06 CE). mvn clean install cd services sh build-images.sh Building with Docker... </td>
</tr>
@@ -1624,6 +1857,76 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
@@ -1736,6 +2039,10 @@
+
+
+
+
@@ -1888,6 +2195,16 @@
+
+
+
+
+
+
+
+
+
+
</tbody>
</table>
@@ -1910,7 +2227,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/tag_model.html b/1.0/tag_model.html
index 8d2e7fa..2920e22 100644
--- a/1.0/tag_model.html
+++ b/1.0/tag_model.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1290,7 +1511,17 @@
- <tr><td><a href="basic-acl.html">Access control list (ACL)</a></td>
+ <tr><td><a href="basic-acknowledgements.html">Acknowledgements</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Available since Ditto 1.1.0 Acknowledgements are a concept in Ditto used to signal that an event was successfully received/processed by either an internal Ditto functionality or an external subscriber of that event. They can be seen as (potentially multiple) responses to a single event (e.g. after a... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="basic-acl.html">Access control list (ACL) - Deprecated</a></td>
<td><span class="label label-default">Page</span></td>
<td> Entries in the ACL configure the permissions for subjects. A subject is identified by an arbitrary ID. Note:... </td>
</tr>
@@ -1335,6 +1566,10 @@
+
+
+
+
<tr><td><a href="basic-feature.html">Feature</a></td>
<td><span class="label label-default">Page</span></td>
@@ -1390,6 +1625,8 @@
+
+
@@ -1500,6 +1737,12 @@
+
+
+
+
+
+
@@ -1530,10 +1773,6 @@
-
-
-
-
@@ -1666,6 +1905,76 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
@@ -1778,6 +2087,10 @@
+
+
+
+
@@ -1930,6 +2243,16 @@
+
+
+
+
+
+
+
+
+
+
</tbody>
</table>
@@ -1952,7 +2275,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/tag_news.html b/1.0/tag_news.html
index 937c28f..1a9c801 100644
--- a/1.0/tag_news.html
+++ b/1.0/tag_news.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1302,6 +1523,14 @@
+
+
+
+
+
+
+
+
@@ -1336,6 +1565,8 @@
+
+
@@ -1426,6 +1657,12 @@
+
+
+
+
+
+
@@ -1454,10 +1691,6 @@
-
-
-
-
@@ -1596,14 +1829,84 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
@@ -1670,6 +1973,10 @@
+
+
+
+
@@ -1870,6 +2177,16 @@
+
+
+
+
+
+
+
+
+
+
</tbody>
</table>
@@ -1892,7 +2209,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/tag_protocol.html b/1.0/tag_protocol.html
index 476133c..9ca220e 100644
--- a/1.0/tag_protocol.html
+++ b/1.0/tag_protocol.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1302,6 +1523,24 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <tr><td><a href="basic-enrichment.html">Signal enrichment</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Available since Ditto 1.1.0 Signals which are emitted to subscribers via WebSocket API, HTTP SSEs or established connections may be enriched by extraFields to also be included in the sent out messages. Events, for example, only contain the actually changed data by... </td>
+ </tr>
@@ -1332,8 +1571,12 @@
-
-
+
+
+ <tr><td><a href="basic-rql.html">RQL expressions</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Ditto utilizes a subset of RQL as language for specifying queries. The RQL project page says about it: Resource Query Language (RQL) is a query language designed for use in URIs with object style data structures. […] RQL can be thought as... </td>
+ </tr>
@@ -1469,6 +1712,18 @@
+
+ <tr><td><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Consume messages from MQTT 5 brokers via sources and send messages to MQTT 5 brokers via targets. Content-type When MQTT messages are sent in Ditto Protocol, the payload should be UTF-8 encoded strings. If messages which are not in Ditto Protocol should be processed, a... </td>
+ </tr>
+
+
+
+
+
+
+
@@ -1499,10 +1754,6 @@
-
-
-
-
<tr><td><a href="httpapi-protocol-bindings-websocket.html">WebSocket protocol binding</a></td>
<td><span class="label label-default">Page</span></td>
@@ -1648,6 +1899,56 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
<tr><td><a href="protocol-examples.html">Protocol examples</a></td>
@@ -1670,6 +1971,56 @@
+ <tr><td><a href="protocol-specification-acks.html">Protocol specification for acknowledgements</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Ditto Protocol messages of acknowledgements come in 2 different protocol topic variants. Acknowledgement An acknowledgment addressing a specific acknowledgement label contains that label as last part of the topic: <namespace>/<thingName>/things/<channel>/acks/<ack-label> The Ditto Protocol representation of an Acknowledgement is specified as follows:... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="protocol-specification-policies-create-or-modify.html">Policies - Create-Or-Modify protocol specification</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Create a Policy Create a Policy with the ID specified by the <namespace>/<policyName> pair in the topic and the JSON representation provided in the value. Command Field Value topic <namespace>/<policyName>/policies/commands/create path / value... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="protocol-specification-policies-delete.html">Policies - Delete protocol specification</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Delete a Policy Delete the policy identified by the <namespace>/<policyName> pair in the topic field. Command Field Value topic <namespace>/<policyName>/policies/commands/delete path / Response Field Value ... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="protocol-specification-policies-retrieve.html">Policies - Retrieve protocol specification</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Note: The topic path of policy commands contains no channel element. See the specification for details. Retrieve a Policy Retrieves a Policy identified by the <namespace>/<policyName> pair in the topic field. Command Field Value ... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="protocol-specification-policies.html">Protocol specification for Policies</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Ditto Protocol topic structure for Policies A valid topic consists of five elements, describing the policy affected by this message and the type of the message: <namespace>/<policyName>/policies/commands/<action> namespace: the namespace of the Policy. policyName: the name of the Policy. group: the... </td>
+ </tr>
+
+
+
+
+
+
<tr><td><a href="protocol-specification-things-create-or-modify.html">Things - Create-Or-Modify protocol specification</a></td>
<td><span class="label label-default">Page</span></td>
<td> All topics contain the <channel> which may be either twin or live. For the meaning of those two channels see Protocol specification. Create a Thing This command creates the thing specified by the <namespace> and <thingId> in the topic defined by... </td>
@@ -1712,8 +2063,7 @@
<tr><td><a href="protocol-specification-things-search.html">Things - Search protocol specification</a></td>
<td><span class="label label-default">Page</span></td>
- <td> Warning: Search commands are not yet mapped in the Ditto protocol.Stay tuned!
- </td>
+ <td> The search aspect of the Ditto protocol consists of 3 commands and 4 events that together implement the reactive-streams protocol over any duplex transport layer. For each search request, Ditto acts as the reactive-streams publisher of pages of search results, and the client acts as the subscriber. By... </td>
</tr>
@@ -1725,7 +2075,7 @@
<tr><td><a href="protocol-specification-things.html">Protocol specification for Things</a></td>
<td><span class="label label-default">Page</span></td>
- <td> Ditto Protocol topic structure for Things A valid topic consists of six elements, describing the thing affected by this message and the type of the message: <namespace>/<thingId>/things/<channel>/<criterion>/<action> namespace: the namespace of the Thing. thingId: the Thing ID. group: the appropriate group... </td>
+ <td> Ditto Protocol topic structure for Things A valid topic consists of six elements, describing the thing affected by this message and the type of the message: <namespace>/<thingName>/things/<channel>/<criterion>/<action> namespace: the namespace of the Thing. thingName: the name of the Thing. group: the... </td>
</tr>
@@ -1735,7 +2085,7 @@
<tr><td><a href="protocol-specification-topic.html">Protocol topic</a></td>
<td><span class="label label-default">Page</span></td>
- <td> The Ditto Protocol defines a Topic for each Protocol message having following structure: {namespace}/{entityId}/{group}/{channel}/{criterion}/{action} Examples for valid topic paths are: org.eclipse.ditto/fancy-car-1/things/twin/commands/create org.eclipse.ditto/fancy-car-0815/things/live/events/modified org.eclipse.ditto/fancy-car-23/things/twin/search org.eclipse.ditto/fancy-car-42/things/live/messages/hello.world Namespace The entity’s namespace in which the entity is located. Entity ID... </td>
+ <td> The Ditto Protocol defines a Topic for each Protocol message having following structure: {namespace}/{entityId}/{group}/{channel}/{criterion}/{action} Examples for valid topic paths are: org.eclipse.ditto/fancy-car-1/things/twin/commands/create org.eclipse.ditto/fancy-car-0815/things/live/events/modified org.eclipse.ditto/fancy-car-23/things/twin/search org.eclipse.ditto/fancy-car-42/things/live/messages/hello.world org.eclipse.ditto/fancy-policy-1/policies/commands/create org.eclipse.ditto/fancy-policy-1/policies/commands/delete Namespace The entity’s namespace in which the entity is... </td>
</tr>
@@ -1745,7 +2095,7 @@
<tr><td><a href="protocol-specification.html">Protocol specification</a></td>
<td><span class="label label-default">Page</span></td>
- <td> In order to comply with the Ditto Protocol, a Protocol message must consist of a Ditto Protocol envelope (JSON) and a Ditto Protocol payload (JSON). Ditto Protocol The communication protocol envelope is implicitly defined by the underlying messaging system (e.g. WebSocket) used to transport/serialize the messages... </td>
+ <td> In order to comply with the Ditto Protocol, a protocol message must consist of a Ditto Protocol envelope (JSON) and a Ditto Protocol payload (JSON). Ditto Protocol The communication protocol envelope is implicitly defined by the underlying messaging system (e.g. WebSocket) used to transport/serialize the messages... </td>
</tr>
@@ -1827,6 +2177,10 @@
+
+
+
+
@@ -1979,6 +2333,16 @@
+
+
+
+
+
+
+
+
+
+
</tbody>
</table>
@@ -2001,7 +2365,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/tag_release_notes.html b/1.0/tag_release_notes.html
index dd6a538..b00e655 100644
--- a/1.0/tag_release_notes.html
+++ b/1.0/tag_release_notes.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1302,6 +1523,10 @@
+
+
+
+
@@ -1346,6 +1571,12 @@
+
+
+
+
+
+
@@ -1440,6 +1671,12 @@
+
+
+
+
+
+
@@ -1470,10 +1707,6 @@
-
-
-
-
@@ -1606,6 +1839,76 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
@@ -1808,6 +2111,16 @@
+
+
+ <tr><td><a href="release_notes_110.html">Release notes 1.1.0</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Version 1.1.0 of Eclipse Ditto, released on 29.04.2020 </td>
+ </tr>
+
+
+
+
@@ -1960,6 +2273,16 @@
+
+
+
+
+
+
+
+
+
+
</tbody>
</table>
@@ -1982,7 +2305,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/tag_rql.html b/1.0/tag_rql.html
index e91fd74..6e8b697 100644
--- a/1.0/tag_rql.html
+++ b/1.0/tag_rql.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1302,6 +1523,10 @@
+
+
+
+
<tr><td><a href="basic-changenotifications.html">Change notifications</a></td>
@@ -1341,6 +1566,10 @@
+
+
+
+
<tr><td><a href="basic-rql.html">RQL expressions</a></td>
<td><span class="label label-default">Page</span></td>
@@ -1348,6 +1577,8 @@
</tr>
+
+
@@ -1356,7 +1587,7 @@
<tr><td><a href="basic-search.html">Search functionality</a></td>
<td><span class="label label-default">Page</span></td>
- <td> Ditto provides a search functionality as one of the services around its managed digital twins. Search index Ditto’s microservice things-search automatically consumes all events which are emitted for changes to Things and Policies and updates an for search optimized representation of the Thing data... </td>
+ <td> Ditto provides a search functionality as one of the services around its managed digital twins. The functionality is available for the following APIs. API Access Method Characteristics HTTP HTTP request-response Stateless Ditto protocol Websocket and connections <a... </td>
</tr>
@@ -1482,6 +1713,12 @@
+
+
+
+
+
+
@@ -1512,10 +1749,6 @@
-
-
-
-
@@ -1548,7 +1781,7 @@
<tr><td><a href="httpapi-sse.html">HTTP API server sent events (SSE)</a></td>
<td><span class="label label-default">Page</span></td>
- <td> HTML5 SSEs may be used in order to get notified when the state of digital twins change. This is the second mechanism of Ditto in order to get change... </td>
+ <td> Server-Sent Events (SSEs) can be used to get notified when the state of digital twins change, and to receive a search results stream. Server-Sent Events Server-Sent Events are... </td>
</tr>
@@ -1666,6 +1899,76 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
@@ -1778,6 +2081,10 @@
+
+
+
+
@@ -1880,6 +2187,16 @@
+
+
+
+
+
+
+
+
+
+
<tr><td><a href="2018-09-21-selective-push-notifications.html">Selective push notifications available</a></td>
<td><span class="label label-primary">Post</span></td>
@@ -1958,7 +2275,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/tag_search.html b/1.0/tag_search.html
index 8953935..7913bd8 100644
--- a/1.0/tag_search.html
+++ b/1.0/tag_search.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1308,6 +1529,10 @@
+
+
+
+
@@ -1345,10 +1570,16 @@
+
+
+
+
+
+
<tr><td><a href="basic-search.html">Search functionality</a></td>
<td><span class="label label-default">Page</span></td>
- <td> Ditto provides a search functionality as one of the services around its managed digital twins. Search index Ditto’s microservice things-search automatically consumes all events which are emitted for changes to Things and Policies and updates an for search optimized representation of the Thing data... </td>
+ <td> Ditto provides a search functionality as one of the services around its managed digital twins. The functionality is available for the following APIs. API Access Method Characteristics HTTP HTTP request-response Stateless Ditto protocol Websocket and connections <a... </td>
</tr>
@@ -1452,6 +1683,12 @@
+
+
+
+
+
+
@@ -1482,10 +1719,6 @@
-
-
-
-
@@ -1624,6 +1857,76 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
@@ -1654,8 +1957,7 @@
<tr><td><a href="protocol-specification-things-search.html">Things - Search protocol specification</a></td>
<td><span class="label label-default">Page</span></td>
- <td> Warning: Search commands are not yet mapped in the Ditto protocol.Stay tuned!
- </td>
+ <td> The search aspect of the Ditto protocol consists of 3 commands and 4 events that together implement the reactive-streams protocol over any duplex transport layer. For each search request, Ditto acts as the reactive-streams publisher of pages of search results, and the client acts as the subscriber. By... </td>
</tr>
@@ -1755,6 +2057,10 @@
+
+
+
+
@@ -1907,6 +2213,16 @@
+
+
+
+
+
+
+
+
+
+
</tbody>
</table>
@@ -1929,7 +2245,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/tag_signal.html b/1.0/tag_signal.html
index cb2c001..faec6a8 100644
--- a/1.0/tag_signal.html
+++ b/1.0/tag_signal.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1302,6 +1523,10 @@
+
+
+
+
@@ -1345,6 +1570,12 @@
+
+
+
+
+
+
<tr><td><a href="basic-signals-command.html">Command</a></td>
<td><span class="label label-default">Page</span></td>
@@ -1475,6 +1706,12 @@
+
+
+
+
+
+
@@ -1505,10 +1742,6 @@
-
-
-
-
@@ -1641,6 +1874,76 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
@@ -1753,6 +2056,10 @@
+
+
+
+
@@ -1905,6 +2212,16 @@
+
+
+
+
+
+
+
+
+
+
</tbody>
</table>
@@ -1927,7 +2244,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/tag_troubleshooting.html b/1.0/tag_troubleshooting.html
index 583a2bf..f907605 100644
--- a/1.0/tag_troubleshooting.html
+++ b/1.0/tag_troubleshooting.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_100.html">1.0.0</a></li>
@@ -532,11 +539,25 @@
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
<li><a href="basic-search.html">Search</a></li>
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
</ul>
</li>
@@ -653,13 +674,6 @@
-
-
- <li><a href="httpapi-postman.html">Run in Postman</a></li>
-
-
-
-
</ul>
</li>
@@ -708,6 +722,13 @@
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
<li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
@@ -840,6 +861,12 @@
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
</ul>
</li>
@@ -869,6 +896,40 @@
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
<li><a href="protocol-bindings.html">Bindings</a></li>
@@ -916,6 +977,12 @@
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
<li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
@@ -1108,7 +1175,7 @@
- <li><a href="protocol-examples-errorresponses.html">Error Responses</a></li>
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
@@ -1117,6 +1184,160 @@
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
</ul>
</li>
@@ -1302,6 +1523,10 @@
+
+
+
+
@@ -1346,6 +1571,12 @@
+
+
+
+
+
+
@@ -1440,6 +1671,12 @@
+
+
+
+
+
+
@@ -1476,10 +1713,6 @@
-
-
-
-
@@ -1612,6 +1845,76 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
@@ -1724,6 +2027,10 @@
+
+
+
+
@@ -1876,6 +2183,16 @@
+
+
+
+
+
+
+
+
+
+
</tbody>
</table>
@@ -1898,7 +2215,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/2017-11-10-welcome-to-ditto.html b/1.1/2017-11-10-welcome-to-ditto.html
index ff1ca3d..efef57a 100644
--- a/1.1/2017-11-10-welcome-to-ditto.html
+++ b/1.1/2017-11-10-welcome-to-ditto.html
@@ -264,7 +264,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/2017-12-18-milestone-announcement-010-M1.html b/1.1/2017-12-18-milestone-announcement-010-M1.html
index 943da44..9f34025 100644
--- a/1.1/2017-12-18-milestone-announcement-010-M1.html
+++ b/1.1/2017-12-18-milestone-announcement-010-M1.html
@@ -268,7 +268,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/2018-01-12-milestone-announcement-010-M3.html b/1.1/2018-01-12-milestone-announcement-010-M3.html
index 9e78b79..a0bb673 100644
--- a/1.1/2018-01-12-milestone-announcement-010-M3.html
+++ b/1.1/2018-01-12-milestone-announcement-010-M3.html
@@ -287,7 +287,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/2018-01-15-example-demonstrating-rest-to-websocket.html b/1.1/2018-01-15-example-demonstrating-rest-to-websocket.html
index d9d565a..18dfb97 100644
--- a/1.1/2018-01-15-example-demonstrating-rest-to-websocket.html
+++ b/1.1/2018-01-15-example-demonstrating-rest-to-websocket.html
@@ -276,7 +276,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/2018-02-07-milestone-announcement-020-M1.html b/1.1/2018-02-07-milestone-announcement-020-M1.html
index cae16a5..1a484d5 100644
--- a/1.1/2018-02-07-milestone-announcement-020-M1.html
+++ b/1.1/2018-02-07-milestone-announcement-020-M1.html
@@ -288,7 +288,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/2018-02-08-feature-definition.html b/1.1/2018-02-08-feature-definition.html
index 75c9a85..fb8c0db 100644
--- a/1.1/2018-02-08-feature-definition.html
+++ b/1.1/2018-02-08-feature-definition.html
@@ -318,7 +318,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/2018-04-25-connectivity-service.html b/1.1/2018-04-25-connectivity-service.html
index 0838fc4..a65e841 100644
--- a/1.1/2018-04-25-connectivity-service.html
+++ b/1.1/2018-04-25-connectivity-service.html
@@ -332,7 +332,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/2018-04-26-milestone-announcement-030-M1.html b/1.1/2018-04-26-milestone-announcement-030-M1.html
index 4160311..b2bb7cc 100644
--- a/1.1/2018-04-26-milestone-announcement-030-M1.html
+++ b/1.1/2018-04-26-milestone-announcement-030-M1.html
@@ -284,7 +284,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/2018-05-02-connecting-ditto-hono.html b/1.1/2018-05-02-connecting-ditto-hono.html
index 04ec8ad..7f01943 100644
--- a/1.1/2018-05-02-connecting-ditto-hono.html
+++ b/1.1/2018-05-02-connecting-ditto-hono.html
@@ -1006,7 +1006,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/2018-06-15-milestone-announcement-030-M2.html b/1.1/2018-06-15-milestone-announcement-030-M2.html
index 5833615..0c1f143 100644
--- a/1.1/2018-06-15-milestone-announcement-030-M2.html
+++ b/1.1/2018-06-15-milestone-announcement-030-M2.html
@@ -284,7 +284,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/2018-08-14-milestone-announcement-080-M1.html b/1.1/2018-08-14-milestone-announcement-080-M1.html
index 31ff483..d8a69bd 100644
--- a/1.1/2018-08-14-milestone-announcement-080-M1.html
+++ b/1.1/2018-08-14-milestone-announcement-080-M1.html
@@ -284,7 +284,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/2018-09-21-selective-push-notifications.html b/1.1/2018-09-21-selective-push-notifications.html
index 6fdab3a..39536ca 100644
--- a/1.1/2018-09-21-selective-push-notifications.html
+++ b/1.1/2018-09-21-selective-push-notifications.html
@@ -484,7 +484,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/2018-09-27-milestone-announcement-080-M2.html b/1.1/2018-09-27-milestone-announcement-080-M2.html
index 3c4d887..e690c4b 100644
--- a/1.1/2018-09-27-milestone-announcement-080-M2.html
+++ b/1.1/2018-09-27-milestone-announcement-080-M2.html
@@ -286,7 +286,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/2018-10-16-example-mqtt-bidirectional.html b/1.1/2018-10-16-example-mqtt-bidirectional.html
index 5cf6186..694c483 100644
--- a/1.1/2018-10-16-example-mqtt-bidirectional.html
+++ b/1.1/2018-10-16-example-mqtt-bidirectional.html
@@ -292,7 +292,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/2018-11-14-milestone-announcement-080-M3.html b/1.1/2018-11-14-milestone-announcement-080-M3.html
index ac87a54..eb285ac 100644
--- a/1.1/2018-11-14-milestone-announcement-080-M3.html
+++ b/1.1/2018-11-14-milestone-announcement-080-M3.html
@@ -285,7 +285,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/2018-11-28-release-announcement-080.html b/1.1/2018-11-28-release-announcement-080.html
index 00c2942..fc5666a 100644
--- a/1.1/2018-11-28-release-announcement-080.html
+++ b/1.1/2018-11-28-release-announcement-080.html
@@ -280,7 +280,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/2018-12-05-example-command-and-control.html b/1.1/2018-12-05-example-command-and-control.html
index 6f71400..0b78c63 100644
--- a/1.1/2018-12-05-example-command-and-control.html
+++ b/1.1/2018-12-05-example-command-and-control.html
@@ -519,7 +519,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/2019-03-13-kafka-connectivity.html b/1.1/2019-03-13-kafka-connectivity.html
index b4aafa6..b9c4a5b 100644
--- a/1.1/2019-03-13-kafka-connectivity.html
+++ b/1.1/2019-03-13-kafka-connectivity.html
@@ -266,7 +266,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/2019-03-28-milestone-announcement-090-M1.html b/1.1/2019-03-28-milestone-announcement-090-M1.html
index 23f3282..2e63693 100644
--- a/1.1/2019-03-28-milestone-announcement-090-M1.html
+++ b/1.1/2019-03-28-milestone-announcement-090-M1.html
@@ -282,7 +282,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/2019-04-29-milestone-announcement-090-M2.html b/1.1/2019-04-29-milestone-announcement-090-M2.html
index ea16b40..63c1251 100644
--- a/1.1/2019-04-29-milestone-announcement-090-M2.html
+++ b/1.1/2019-04-29-milestone-announcement-090-M2.html
@@ -280,7 +280,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/2019-07-10-release-announcement-090.html b/1.1/2019-07-10-release-announcement-090.html
index c7d6419..bc931fd 100644
--- a/1.1/2019-07-10-release-announcement-090.html
+++ b/1.1/2019-07-10-release-announcement-090.html
@@ -286,7 +286,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/2019-08-28-openid-connect.html b/1.1/2019-08-28-openid-connect.html
index 12f77f3..940c1ab 100644
--- a/1.1/2019-08-28-openid-connect.html
+++ b/1.1/2019-08-28-openid-connect.html
@@ -332,7 +332,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/2019-09-17-milestone-announcement-100-M1a.html b/1.1/2019-09-17-milestone-announcement-100-M1a.html
index a32e9a9..144f3fa 100644
--- a/1.1/2019-09-17-milestone-announcement-100-M1a.html
+++ b/1.1/2019-09-17-milestone-announcement-100-M1a.html
@@ -283,7 +283,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/2019-10-17-http-connectivity.html b/1.1/2019-10-17-http-connectivity.html
index ccecc99..c39e1c9 100644
--- a/1.1/2019-10-17-http-connectivity.html
+++ b/1.1/2019-10-17-http-connectivity.html
@@ -291,7 +291,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/2019-11-04-milestone-announcement-100-M2.html b/1.1/2019-11-04-milestone-announcement-100-M2.html
index 44ba91f..ea00975 100644
--- a/1.1/2019-11-04-milestone-announcement-100-M2.html
+++ b/1.1/2019-11-04-milestone-announcement-100-M2.html
@@ -282,7 +282,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/2019-12-12-release-announcement-100.html b/1.1/2019-12-12-release-announcement-100.html
index 359cee2..7ff13a3 100644
--- a/1.1/2019-12-12-release-announcement-100.html
+++ b/1.1/2019-12-12-release-announcement-100.html
@@ -331,7 +331,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/2020-04-16-connecting-to-ttn-via-mqtt.html b/1.1/2020-04-16-connecting-to-ttn-via-mqtt.html
index 5abff99..d141522 100644
--- a/1.1/2020-04-16-connecting-to-ttn-via-mqtt.html
+++ b/1.1/2020-04-16-connecting-to-ttn-via-mqtt.html
@@ -778,7 +778,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/2020-04-29-release-announcement-110.html b/1.1/2020-04-29-release-announcement-110.html
index da9940c..9529814 100644
--- a/1.1/2020-04-29-release-announcement-110.html
+++ b/1.1/2020-04-29-release-announcement-110.html
@@ -312,7 +312,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/404.html b/1.1/404.html
index a42a0cf..c398544 100644
--- a/1.1/404.html
+++ b/1.1/404.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1485,7 +1504,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/architecture-overview.html b/1.1/architecture-overview.html
index ea4c0b4..b56b22e 100644
--- a/1.1/architecture-overview.html
+++ b/1.1/architecture-overview.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1538,7 +1557,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/architecture-services-concierge.html b/1.1/architecture-services-concierge.html
index fad58a7..e83bba5 100644
--- a/1.1/architecture-services-concierge.html
+++ b/1.1/architecture-services-concierge.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1524,7 +1543,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/architecture-services-connectivity.html b/1.1/architecture-services-connectivity.html
index 595cff6..6b79896 100644
--- a/1.1/architecture-services-connectivity.html
+++ b/1.1/architecture-services-connectivity.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1538,7 +1557,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/architecture-services-gateway.html b/1.1/architecture-services-gateway.html
index fe23628..010f88d 100644
--- a/1.1/architecture-services-gateway.html
+++ b/1.1/architecture-services-gateway.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1516,7 +1535,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/architecture-services-policies.html b/1.1/architecture-services-policies.html
index fa497e1..d956473 100644
--- a/1.1/architecture-services-policies.html
+++ b/1.1/architecture-services-policies.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1517,7 +1536,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/architecture-services-things-search.html b/1.1/architecture-services-things-search.html
index 5b76fb8..eccd5c1 100644
--- a/1.1/architecture-services-things-search.html
+++ b/1.1/architecture-services-things-search.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1561,7 +1580,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/architecture-services-things.html b/1.1/architecture-services-things.html
index f035b69..2905b40 100644
--- a/1.1/architecture-services-things.html
+++ b/1.1/architecture-services-things.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1517,7 +1536,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/basic-acknowledgements.html b/1.1/basic-acknowledgements.html
index bb26963..a00e1a7 100644
--- a/1.1/basic-acknowledgements.html
+++ b/1.1/basic-acknowledgements.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1666,7 +1685,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/basic-acl.html b/1.1/basic-acl.html
index 1c5f987..a6cc73a 100644
--- a/1.1/basic-acl.html
+++ b/1.1/basic-acl.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1555,7 +1574,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/basic-apis.html b/1.1/basic-apis.html
index 1dbe85b..c9c175b 100644
--- a/1.1/basic-apis.html
+++ b/1.1/basic-apis.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1613,7 +1632,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/basic-auth.html b/1.1/basic-auth.html
index 87c4bd3..24a6bfb 100644
--- a/1.1/basic-auth.html
+++ b/1.1/basic-auth.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1534,7 +1553,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/basic-changenotifications.html b/1.1/basic-changenotifications.html
index 6b6213d..b1db2fd 100644
--- a/1.1/basic-changenotifications.html
+++ b/1.1/basic-changenotifications.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1557,7 +1576,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/basic-connections.html b/1.1/basic-connections.html
index d5f316d..6a2e80f 100644
--- a/1.1/basic-connections.html
+++ b/1.1/basic-connections.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1952,7 +1971,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/basic-enrichment.html b/1.1/basic-enrichment.html
index a3fa16e..f102506 100644
--- a/1.1/basic-enrichment.html
+++ b/1.1/basic-enrichment.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1590,7 +1609,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/basic-feature.html b/1.1/basic-feature.html
index eb0406e..78e17fc 100644
--- a/1.1/basic-feature.html
+++ b/1.1/basic-feature.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1718,7 +1737,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/basic-messages.html b/1.1/basic-messages.html
index 6d9bfff..2dd57d9 100644
--- a/1.1/basic-messages.html
+++ b/1.1/basic-messages.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1627,7 +1646,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/basic-namespaces-and-names.html b/1.1/basic-namespaces-and-names.html
index 68df454..ab20717 100644
--- a/1.1/basic-namespaces-and-names.html
+++ b/1.1/basic-namespaces-and-names.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1557,7 +1576,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/basic-overview.html b/1.1/basic-overview.html
index ad79df0..9266811 100644
--- a/1.1/basic-overview.html
+++ b/1.1/basic-overview.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1630,7 +1649,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/basic-placeholders.html b/1.1/basic-placeholders.html
index d92c535..edbb836 100644
--- a/1.1/basic-placeholders.html
+++ b/1.1/basic-placeholders.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1750,7 +1769,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/basic-policy.html b/1.1/basic-policy.html
index 82d42a6..f2e0633 100644
--- a/1.1/basic-policy.html
+++ b/1.1/basic-policy.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1896,7 +1915,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/basic-rql.html b/1.1/basic-rql.html
index 0bdf387..9a8bbb9 100644
--- a/1.1/basic-rql.html
+++ b/1.1/basic-rql.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1736,7 +1755,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/basic-search.html b/1.1/basic-search.html
index c9538b9..a4166fd 100644
--- a/1.1/basic-search.html
+++ b/1.1/basic-search.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1629,7 +1648,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/basic-signals-command.html b/1.1/basic-signals-command.html
index a597fe7..583300f 100644
--- a/1.1/basic-signals-command.html
+++ b/1.1/basic-signals-command.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1515,7 +1534,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/basic-signals-commandresponse.html b/1.1/basic-signals-commandresponse.html
index 6d6e8da..82a8e5f 100644
--- a/1.1/basic-signals-commandresponse.html
+++ b/1.1/basic-signals-commandresponse.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1495,7 +1514,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/basic-signals-errorresponse.html b/1.1/basic-signals-errorresponse.html
index d18db7d..bcc85a1 100644
--- a/1.1/basic-signals-errorresponse.html
+++ b/1.1/basic-signals-errorresponse.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1497,7 +1516,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/basic-signals-event.html b/1.1/basic-signals-event.html
index bebb3f3..692ac4c 100644
--- a/1.1/basic-signals-event.html
+++ b/1.1/basic-signals-event.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1501,7 +1520,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/basic-signals.html b/1.1/basic-signals.html
index cdff9e2..7bc6755 100644
--- a/1.1/basic-signals.html
+++ b/1.1/basic-signals.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1545,7 +1564,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/basic-thing.html b/1.1/basic-thing.html
index 04e4b42..75504ca 100644
--- a/1.1/basic-thing.html
+++ b/1.1/basic-thing.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1581,7 +1600,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/blog.html b/1.1/blog.html
index 146e789..65ba896 100644
--- a/1.1/blog.html
+++ b/1.1/blog.html
@@ -393,7 +393,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/blog_archive.html b/1.1/blog_archive.html
index f22e70f..5bece99 100644
--- a/1.1/blog_archive.html
+++ b/1.1/blog_archive.html
@@ -446,7 +446,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/client-sdk-java.html b/1.1/client-sdk-java.html
index 95eeb9f..2a1ee4d 100644
--- a/1.1/client-sdk-java.html
+++ b/1.1/client-sdk-java.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1742,7 +1761,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/client-sdk-javascript.html b/1.1/client-sdk-javascript.html
index f3024e1..5195a6e 100644
--- a/1.1/client-sdk-javascript.html
+++ b/1.1/client-sdk-javascript.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1551,7 +1570,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/client-sdk-overview.html b/1.1/client-sdk-overview.html
index b3ad270..92bbca6 100644
--- a/1.1/client-sdk-overview.html
+++ b/1.1/client-sdk-overview.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1498,7 +1517,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/connectivity-header-mapping.html b/1.1/connectivity-header-mapping.html
index 87e10cc..bc61a53 100644
--- a/1.1/connectivity-header-mapping.html
+++ b/1.1/connectivity-header-mapping.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1508,7 +1527,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/connectivity-manage-connections.html b/1.1/connectivity-manage-connections.html
index f0b0206..c2e14e9 100644
--- a/1.1/connectivity-manage-connections.html
+++ b/1.1/connectivity-manage-connections.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1813,7 +1832,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/connectivity-mapping.html b/1.1/connectivity-mapping.html
index 771d29a..e096012 100644
--- a/1.1/connectivity-mapping.html
+++ b/1.1/connectivity-mapping.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -2278,7 +2297,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/connectivity-overview.html b/1.1/connectivity-overview.html
index 2e6d8a1..11abc6c 100644
--- a/1.1/connectivity-overview.html
+++ b/1.1/connectivity-overview.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1509,7 +1528,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/connectivity-protocol-bindings-amqp091.html b/1.1/connectivity-protocol-bindings-amqp091.html
index a317f97..cdfea99 100644
--- a/1.1/connectivity-protocol-bindings-amqp091.html
+++ b/1.1/connectivity-protocol-bindings-amqp091.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1607,7 +1626,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/connectivity-protocol-bindings-amqp10.html b/1.1/connectivity-protocol-bindings-amqp10.html
index cf01526..00cabbd 100644
--- a/1.1/connectivity-protocol-bindings-amqp10.html
+++ b/1.1/connectivity-protocol-bindings-amqp10.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1653,7 +1672,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/connectivity-protocol-bindings-http.html b/1.1/connectivity-protocol-bindings-http.html
index 30c8345..2c046e4 100644
--- a/1.1/connectivity-protocol-bindings-http.html
+++ b/1.1/connectivity-protocol-bindings-http.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1598,7 +1617,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/connectivity-protocol-bindings-kafka2.html b/1.1/connectivity-protocol-bindings-kafka2.html
index b20711f..8a1e875 100644
--- a/1.1/connectivity-protocol-bindings-kafka2.html
+++ b/1.1/connectivity-protocol-bindings-kafka2.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1597,7 +1616,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/connectivity-protocol-bindings-mqtt.html b/1.1/connectivity-protocol-bindings-mqtt.html
index 80370aa..00b0585 100644
--- a/1.1/connectivity-protocol-bindings-mqtt.html
+++ b/1.1/connectivity-protocol-bindings-mqtt.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li class="active"><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1702,7 +1721,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/connectivity-protocol-bindings-mqtt5.html b/1.1/connectivity-protocol-bindings-mqtt5.html
index 972334b..ef2a406 100644
--- a/1.1/connectivity-protocol-bindings-mqtt5.html
+++ b/1.1/connectivity-protocol-bindings-mqtt5.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li class="active"><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1670,7 +1689,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/connectivity-tls-certificates.html b/1.1/connectivity-tls-certificates.html
index 029d3c9..d1fd756 100644
--- a/1.1/connectivity-tls-certificates.html
+++ b/1.1/connectivity-tls-certificates.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1604,7 +1623,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/feedback.html b/1.1/feedback.html
index 1cc7456..c134593 100644
--- a/1.1/feedback.html
+++ b/1.1/feedback.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1510,7 +1529,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/glossary.html b/1.1/glossary.html
index b946d65..ab18a2f 100644
--- a/1.1/glossary.html
+++ b/1.1/glossary.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1498,7 +1517,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/http-api-doc.html b/1.1/http-api-doc.html
index 438dbc7..74e8345 100644
--- a/1.1/http-api-doc.html
+++ b/1.1/http-api-doc.html
@@ -201,7 +201,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/httpapi-concepts.html b/1.1/httpapi-concepts.html
index 22987b8..3749c07 100644
--- a/1.1/httpapi-concepts.html
+++ b/1.1/httpapi-concepts.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -2084,7 +2103,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/httpapi-messages.html b/1.1/httpapi-messages.html
index 25adf15..7318d36 100644
--- a/1.1/httpapi-messages.html
+++ b/1.1/httpapi-messages.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1586,7 +1605,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/httpapi-overview.html b/1.1/httpapi-overview.html
index 23d20bb..155d47f 100644
--- a/1.1/httpapi-overview.html
+++ b/1.1/httpapi-overview.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1506,7 +1525,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/httpapi-protocol-bindings-websocket.html b/1.1/httpapi-protocol-bindings-websocket.html
index 9c9f1da..624c715 100644
--- a/1.1/httpapi-protocol-bindings-websocket.html
+++ b/1.1/httpapi-protocol-bindings-websocket.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1786,7 +1805,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/httpapi-search.html b/1.1/httpapi-search.html
index 49b1430..5c7434d 100644
--- a/1.1/httpapi-search.html
+++ b/1.1/httpapi-search.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1553,7 +1572,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/httpapi-sse.html b/1.1/httpapi-sse.html
index ba1ae14..c5a25c8 100644
--- a/1.1/httpapi-sse.html
+++ b/1.1/httpapi-sse.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1732,7 +1751,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/index.html b/1.1/index.html
index 6579219..05f1f66 100644
--- a/1.1/index.html
+++ b/1.1/index.html
@@ -264,7 +264,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/installation-building.html b/1.1/installation-building.html
index a3fc498..4811c13 100644
--- a/1.1/installation-building.html
+++ b/1.1/installation-building.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1525,7 +1544,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/installation-operating.html b/1.1/installation-operating.html
index 8d90e94..9cb40f5 100644
--- a/1.1/installation-operating.html
+++ b/1.1/installation-operating.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -2381,7 +2400,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/installation-running.html b/1.1/installation-running.html
index b04cc9a..044718a 100644
--- a/1.1/installation-running.html
+++ b/1.1/installation-running.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1553,7 +1572,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/intro-digitaltwins.html b/1.1/intro-digitaltwins.html
index 3caf25e..cc2197a 100644
--- a/1.1/intro-digitaltwins.html
+++ b/1.1/intro-digitaltwins.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1528,7 +1547,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/intro-hello-world.html b/1.1/intro-hello-world.html
index 507af57..81375a9 100644
--- a/1.1/intro-hello-world.html
+++ b/1.1/intro-hello-world.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1617,7 +1636,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/intro-overview.html b/1.1/intro-overview.html
index 0bb2405..6981d1f 100644
--- a/1.1/intro-overview.html
+++ b/1.1/intro-overview.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1544,7 +1563,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/openapi/ditto-api-1.yml b/1.1/openapi/ditto-api-1.yml
index c33cbd4..900ea45 100644
--- a/1.1/openapi/ditto-api-1.yml
+++ b/1.1/openapi/ditto-api-1.yml
@@ -12,9 +12,6 @@
info:
title: Eclipse Ditto HTTP API - Deprecated
description: JSON-based, REST-like API for Eclipse Ditto
-
- Find a guide to migrate things from API 1 to API 2 [here](https://www.eclipse.org/ditto/httpapi-concepts.html/#migration-from-api-1-to-api-2)
-
version: "1"
servers:
- url: https://ditto.eclipse.org/api/1
diff --git a/1.1/openapi/ditto-api-2.yml b/1.1/openapi/ditto-api-2.yml
index 6eae81a..5cdb377 100644
--- a/1.1/openapi/ditto-api-2.yml
+++ b/1.1/openapi/ditto-api-2.yml
@@ -3103,7 +3103,7 @@
Note: Take care to not lock yourself out. Use the placeholder {{ request:subjectId }}
in order to let the backend insert the authenticated subjectId of the HTTP request.
tags:
- - policies
+ - Policies
parameters:
- $ref: '#/components/parameters/policyIdPathParam'
- $ref: '#/components/parameters/ifMatchHeaderParamHash'
@@ -3210,7 +3210,7 @@
parameter, and by the `label` path parameter.
Example label: DEFAULT.
tags:
- - policies
+ - Policies
parameters:
- $ref: '#/components/parameters/policyIdPathParam'
- $ref: '#/components/parameters/labelPathParam'
@@ -3271,7 +3271,7 @@
* If you specify a new label, the respective policy entry will be created
* If you specify an existig label, the respective policy entry will be updated
tags:
- - policies
+ - Policies
parameters:
- $ref: '#/components/parameters/policyIdPathParam'
- $ref: '#/components/parameters/labelPathParam'
@@ -3425,7 +3425,7 @@
Deletes the entry of the policy identified by the `policyId` path
parameter and with the label identified by the `label` path parameter.
tags:
- - policies
+ - Policies
parameters:
- $ref: '#/components/parameters/policyIdPathParam'
- $ref: '#/components/parameters/labelPathParam'
@@ -3480,7 +3480,7 @@
`policyId` path parameter, and by the `label`
path parameter.
tags:
- - policies
+ - Policies
parameters:
- $ref: '#/components/parameters/policyIdPathParam'
- $ref: '#/components/parameters/labelPathParam'
@@ -3550,7 +3550,7 @@
}
```
tags:
- - policies
+ - Policies
parameters:
- $ref: '#/components/parameters/policyIdPathParam'
- $ref: '#/components/parameters/labelPathParam'
@@ -3629,7 +3629,7 @@
Returns the subject with ID `subjectId` of the policy entry identified
by the `policyId` path parameter, and by the `label` path parameter.
tags:
- - policies
+ - Policies
parameters:
- $ref: '#/components/parameters/policyIdPathParam'
- $ref: '#/components/parameters/labelPathParam'
@@ -3689,7 +3689,7 @@
by the `policyId` path parameter, and
by the `label` path parameter.
tags:
- - policies
+ - Policies
parameters:
- $ref: '#/components/parameters/policyIdPathParam'
- $ref: '#/components/parameters/labelPathParam'
@@ -3785,7 +3785,7 @@
i.e. it will not lose those permissions, but only the permissions defined in the
label specified at this path.
tags:
- - policies
+ - Policies
parameters:
- $ref: '#/components/parameters/policyIdPathParam'
- $ref: '#/components/parameters/labelPathParam'
@@ -3842,7 +3842,7 @@
the `policyId` path parameter,
and by the `label` path parameter.
tags:
- - policies
+ - Policies
parameters:
- $ref: '#/components/parameters/policyIdPathParam'
- $ref: '#/components/parameters/labelPathParam'
@@ -3944,7 +3944,7 @@
}
```
tags:
- - policies
+ - Policies
parameters:
- $ref: '#/components/parameters/policyIdPathParam'
- $ref: '#/components/parameters/labelPathParam'
@@ -4019,7 +4019,7 @@
by the `policyId` path parameter, and
by the `label` path parameter.
tags:
- - policies
+ - Policies
parameters:
- $ref: '#/components/parameters/policyIdPathParam'
- $ref: '#/components/parameters/labelPathParam'
@@ -4079,7 +4079,7 @@
entry identified by the `label` path parameter belonging to the policy
identified by the `policyId` path parameter.
tags:
- - policies
+ - Policies
parameters:
- $ref: '#/components/parameters/policyIdPathParam'
- $ref: '#/components/parameters/labelPathParam'
@@ -4173,7 +4173,7 @@
identified by the the `policyId` path parameter, and by the
`label` path parameter.
tags:
- - policies
+ - Policies
parameters:
- $ref: '#/components/parameters/policyIdPathParam'
- $ref: '#/components/parameters/labelPathParam'
diff --git a/1.1/presentations.html b/1.1/presentations.html
index 1de0883..3aad165 100644
--- a/1.1/presentations.html
+++ b/1.1/presentations.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1526,7 +1545,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-bindings.html b/1.1/protocol-bindings.html
index 363db21..695514c 100644
--- a/1.1/protocol-bindings.html
+++ b/1.1/protocol-bindings.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1517,7 +1536,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-createattribute.html b/1.1/protocol-examples-createattribute.html
index ba47041..c91721b 100644
--- a/1.1/protocol-examples-createattribute.html
+++ b/1.1/protocol-examples-createattribute.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1520,7 +1539,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-createattributes.html b/1.1/protocol-examples-createattributes.html
index 88b3b51..be289ce 100644
--- a/1.1/protocol-examples-createattributes.html
+++ b/1.1/protocol-examples-createattributes.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1525,7 +1544,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-createdefinition.html b/1.1/protocol-examples-createdefinition.html
index af2496c..62333ad 100644
--- a/1.1/protocol-examples-createdefinition.html
+++ b/1.1/protocol-examples-createdefinition.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1518,7 +1537,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-createfeature.html b/1.1/protocol-examples-createfeature.html
index 16b2a1a..22e96e3 100644
--- a/1.1/protocol-examples-createfeature.html
+++ b/1.1/protocol-examples-createfeature.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1529,7 +1548,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-createfeatures.html b/1.1/protocol-examples-createfeatures.html
index a8096e3..337df30 100644
--- a/1.1/protocol-examples-createfeatures.html
+++ b/1.1/protocol-examples-createfeatures.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1533,7 +1552,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-createproperties.html b/1.1/protocol-examples-createproperties.html
index e120783..864ac94 100644
--- a/1.1/protocol-examples-createproperties.html
+++ b/1.1/protocol-examples-createproperties.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1524,7 +1543,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-createproperty.html b/1.1/protocol-examples-createproperty.html
index 736ee58..2e29b01 100644
--- a/1.1/protocol-examples-createproperty.html
+++ b/1.1/protocol-examples-createproperty.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1514,7 +1533,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-creatething.html b/1.1/protocol-examples-creatething.html
index edd8843..5457863 100644
--- a/1.1/protocol-examples-creatething.html
+++ b/1.1/protocol-examples-creatething.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1613,7 +1632,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-createthingdefinition.html b/1.1/protocol-examples-createthingdefinition.html
index 7d49dd4..bd36ecc 100644
--- a/1.1/protocol-examples-createthingdefinition.html
+++ b/1.1/protocol-examples-createthingdefinition.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1515,7 +1534,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-deleteattribute.html b/1.1/protocol-examples-deleteattribute.html
index 79209fb..b72755d 100644
--- a/1.1/protocol-examples-deleteattribute.html
+++ b/1.1/protocol-examples-deleteattribute.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1512,7 +1531,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-deleteattributes.html b/1.1/protocol-examples-deleteattributes.html
index 66d4bfd..138b994 100644
--- a/1.1/protocol-examples-deleteattributes.html
+++ b/1.1/protocol-examples-deleteattributes.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1512,7 +1531,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-deletedefinition.html b/1.1/protocol-examples-deletedefinition.html
index 499bbf5..104912a 100644
--- a/1.1/protocol-examples-deletedefinition.html
+++ b/1.1/protocol-examples-deletedefinition.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1512,7 +1531,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-deletefeature.html b/1.1/protocol-examples-deletefeature.html
index 6d93b89..8af731d 100644
--- a/1.1/protocol-examples-deletefeature.html
+++ b/1.1/protocol-examples-deletefeature.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1512,7 +1531,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-deletefeatures.html b/1.1/protocol-examples-deletefeatures.html
index be9d931..624b8de 100644
--- a/1.1/protocol-examples-deletefeatures.html
+++ b/1.1/protocol-examples-deletefeatures.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1512,7 +1531,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-deleteproperties.html b/1.1/protocol-examples-deleteproperties.html
index 014b1a3..06830fd 100644
--- a/1.1/protocol-examples-deleteproperties.html
+++ b/1.1/protocol-examples-deleteproperties.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1512,7 +1531,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-deleteproperty.html b/1.1/protocol-examples-deleteproperty.html
index a8aae34..190cb9e 100644
--- a/1.1/protocol-examples-deleteproperty.html
+++ b/1.1/protocol-examples-deleteproperty.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1512,7 +1531,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-deletething.html b/1.1/protocol-examples-deletething.html
index 208be3c..ea9d1c5 100644
--- a/1.1/protocol-examples-deletething.html
+++ b/1.1/protocol-examples-deletething.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1512,7 +1531,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-deletethingdefinition.html b/1.1/protocol-examples-deletethingdefinition.html
index 278565a..05c5407 100644
--- a/1.1/protocol-examples-deletethingdefinition.html
+++ b/1.1/protocol-examples-deletethingdefinition.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1512,7 +1531,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-errorresponses.html b/1.1/protocol-examples-errorresponses.html
index c1f9d6c..4337d6d 100644
--- a/1.1/protocol-examples-errorresponses.html
+++ b/1.1/protocol-examples-errorresponses.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1947,7 +1966,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-modifyattribute.html b/1.1/protocol-examples-modifyattribute.html
index 46d1db3..6406d26 100644
--- a/1.1/protocol-examples-modifyattribute.html
+++ b/1.1/protocol-examples-modifyattribute.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1520,7 +1539,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-modifyattributes.html b/1.1/protocol-examples-modifyattributes.html
index 21f9f1d..e623868 100644
--- a/1.1/protocol-examples-modifyattributes.html
+++ b/1.1/protocol-examples-modifyattributes.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1525,7 +1544,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-modifydefinition.html b/1.1/protocol-examples-modifydefinition.html
index eb49dbe..5a42361 100644
--- a/1.1/protocol-examples-modifydefinition.html
+++ b/1.1/protocol-examples-modifydefinition.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1518,7 +1537,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-modifyfeature.html b/1.1/protocol-examples-modifyfeature.html
index 39c555d..beeebe3 100644
--- a/1.1/protocol-examples-modifyfeature.html
+++ b/1.1/protocol-examples-modifyfeature.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1529,7 +1548,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-modifyfeatures.html b/1.1/protocol-examples-modifyfeatures.html
index 0f6b770..5b17826 100644
--- a/1.1/protocol-examples-modifyfeatures.html
+++ b/1.1/protocol-examples-modifyfeatures.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1533,7 +1552,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-modifypolicyid.html b/1.1/protocol-examples-modifypolicyid.html
index 123b050..33a8e54 100644
--- a/1.1/protocol-examples-modifypolicyid.html
+++ b/1.1/protocol-examples-modifypolicyid.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1536,7 +1555,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-modifyproperties.html b/1.1/protocol-examples-modifyproperties.html
index ad509ae..07a6fd2 100644
--- a/1.1/protocol-examples-modifyproperties.html
+++ b/1.1/protocol-examples-modifyproperties.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1524,7 +1543,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-modifyproperty.html b/1.1/protocol-examples-modifyproperty.html
index f282188..5811297 100644
--- a/1.1/protocol-examples-modifyproperty.html
+++ b/1.1/protocol-examples-modifyproperty.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1514,7 +1533,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-modifything.html b/1.1/protocol-examples-modifything.html
index ceda84b..1a53cdf 100644
--- a/1.1/protocol-examples-modifything.html
+++ b/1.1/protocol-examples-modifything.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1594,7 +1613,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-modifythingdefinition.html b/1.1/protocol-examples-modifythingdefinition.html
index d01a320..3438039 100644
--- a/1.1/protocol-examples-modifythingdefinition.html
+++ b/1.1/protocol-examples-modifythingdefinition.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1514,7 +1533,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-policies-createpolicy.html b/1.1/protocol-examples-policies-createpolicy.html
index 7ab3205..f33ea42 100644
--- a/1.1/protocol-examples-policies-createpolicy.html
+++ b/1.1/protocol-examples-policies-createpolicy.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1548,7 +1567,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-policies-createpolicyentry.html b/1.1/protocol-examples-policies-createpolicyentry.html
index dce8497..d0c4143 100644
--- a/1.1/protocol-examples-policies-createpolicyentry.html
+++ b/1.1/protocol-examples-policies-createpolicyentry.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1524,7 +1543,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-policies-createresource.html b/1.1/protocol-examples-policies-createresource.html
index 1d1bae5..d2ec1fd 100644
--- a/1.1/protocol-examples-policies-createresource.html
+++ b/1.1/protocol-examples-policies-createresource.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1513,7 +1532,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-policies-createsubject.html b/1.1/protocol-examples-policies-createsubject.html
index 7d81ea9..6fd1550 100644
--- a/1.1/protocol-examples-policies-createsubject.html
+++ b/1.1/protocol-examples-policies-createsubject.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1509,7 +1528,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-policies-deletepolicy.html b/1.1/protocol-examples-policies-deletepolicy.html
index 28cb5b9..9c0e69e 100644
--- a/1.1/protocol-examples-policies-deletepolicy.html
+++ b/1.1/protocol-examples-policies-deletepolicy.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1506,7 +1525,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-policies-deletepolicyentry.html b/1.1/protocol-examples-policies-deletepolicyentry.html
index a01aeba..a32d227 100644
--- a/1.1/protocol-examples-policies-deletepolicyentry.html
+++ b/1.1/protocol-examples-policies-deletepolicyentry.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1506,7 +1525,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-policies-deleteresource.html b/1.1/protocol-examples-policies-deleteresource.html
index 04b04e3..42b95c0 100644
--- a/1.1/protocol-examples-policies-deleteresource.html
+++ b/1.1/protocol-examples-policies-deleteresource.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1506,7 +1525,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-policies-deletesubject.html b/1.1/protocol-examples-policies-deletesubject.html
index fc4afd9..b0ca1b2 100644
--- a/1.1/protocol-examples-policies-deletesubject.html
+++ b/1.1/protocol-examples-policies-deletesubject.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1506,7 +1525,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-policies-errorresponses.html b/1.1/protocol-examples-policies-errorresponses.html
index 833ed0f..daa5334 100644
--- a/1.1/protocol-examples-policies-errorresponses.html
+++ b/1.1/protocol-examples-policies-errorresponses.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1844,7 +1863,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-policies-modifypolicy.html b/1.1/protocol-examples-policies-modifypolicy.html
index c2411a9..2ee40d4 100644
--- a/1.1/protocol-examples-policies-modifypolicy.html
+++ b/1.1/protocol-examples-policies-modifypolicy.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1527,7 +1546,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-policies-modifypolicyentries.html b/1.1/protocol-examples-policies-modifypolicyentries.html
index 79bce7f..08c776d 100644
--- a/1.1/protocol-examples-policies-modifypolicyentries.html
+++ b/1.1/protocol-examples-policies-modifypolicyentries.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1546,7 +1565,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-policies-modifypolicyentry.html b/1.1/protocol-examples-policies-modifypolicyentry.html
index ca258a2..f65d981 100644
--- a/1.1/protocol-examples-policies-modifypolicyentry.html
+++ b/1.1/protocol-examples-policies-modifypolicyentry.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1524,7 +1543,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-policies-modifyresource.html b/1.1/protocol-examples-policies-modifyresource.html
index 3984ad4..cbb43a3 100644
--- a/1.1/protocol-examples-policies-modifyresource.html
+++ b/1.1/protocol-examples-policies-modifyresource.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1513,7 +1532,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-policies-modifyresources.html b/1.1/protocol-examples-policies-modifyresources.html
index c5140e5..8e6bf3f 100644
--- a/1.1/protocol-examples-policies-modifyresources.html
+++ b/1.1/protocol-examples-policies-modifyresources.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1516,7 +1535,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-policies-modifysubject.html b/1.1/protocol-examples-policies-modifysubject.html
index 6e5d94f..4cb8f26 100644
--- a/1.1/protocol-examples-policies-modifysubject.html
+++ b/1.1/protocol-examples-policies-modifysubject.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1509,7 +1528,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-policies-modifysubjects.html b/1.1/protocol-examples-policies-modifysubjects.html
index 41c6cb1..abe6807 100644
--- a/1.1/protocol-examples-policies-modifysubjects.html
+++ b/1.1/protocol-examples-policies-modifysubjects.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1512,7 +1531,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-policies-retrievepolicy.html b/1.1/protocol-examples-policies-retrievepolicy.html
index 3e19110..7ef8237 100644
--- a/1.1/protocol-examples-policies-retrievepolicy.html
+++ b/1.1/protocol-examples-policies-retrievepolicy.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1527,7 +1546,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-policies-retrievepolicyentries.html b/1.1/protocol-examples-policies-retrievepolicyentries.html
index 6098654..c256203 100644
--- a/1.1/protocol-examples-policies-retrievepolicyentries.html
+++ b/1.1/protocol-examples-policies-retrievepolicyentries.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1540,7 +1559,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-policies-retrievepolicyentry.html b/1.1/protocol-examples-policies-retrievepolicyentry.html
index 23c923e..ebb8c89 100644
--- a/1.1/protocol-examples-policies-retrievepolicyentry.html
+++ b/1.1/protocol-examples-policies-retrievepolicyentry.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1522,7 +1541,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-policies-retrieveresource.html b/1.1/protocol-examples-policies-retrieveresource.html
index c82ba8f..ff017af 100644
--- a/1.1/protocol-examples-policies-retrieveresource.html
+++ b/1.1/protocol-examples-policies-retrieveresource.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1513,7 +1532,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-policies-retrieveresources.html b/1.1/protocol-examples-policies-retrieveresources.html
index a846f1e..1f957bf 100644
--- a/1.1/protocol-examples-policies-retrieveresources.html
+++ b/1.1/protocol-examples-policies-retrieveresources.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1515,7 +1534,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-policies-retrievesubject.html b/1.1/protocol-examples-policies-retrievesubject.html
index 06a16ce..eb891e4 100644
--- a/1.1/protocol-examples-policies-retrievesubject.html
+++ b/1.1/protocol-examples-policies-retrievesubject.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1509,7 +1528,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-policies-retrievesubjects.html b/1.1/protocol-examples-policies-retrievesubjects.html
index 2e9ec23..820bc1f 100644
--- a/1.1/protocol-examples-policies-retrievesubjects.html
+++ b/1.1/protocol-examples-policies-retrievesubjects.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1511,7 +1530,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-retrieveattribute.html b/1.1/protocol-examples-retrieveattribute.html
index d016bb7..e6217d5 100644
--- a/1.1/protocol-examples-retrieveattribute.html
+++ b/1.1/protocol-examples-retrieveattribute.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1506,7 +1525,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-retrieveattributes.html b/1.1/protocol-examples-retrieveattributes.html
index ba1b2c0..2ea9cc9 100644
--- a/1.1/protocol-examples-retrieveattributes.html
+++ b/1.1/protocol-examples-retrieveattributes.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1508,7 +1527,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-retrievedefinition.html b/1.1/protocol-examples-retrievedefinition.html
index 9d97624..47f4075 100644
--- a/1.1/protocol-examples-retrievedefinition.html
+++ b/1.1/protocol-examples-retrievedefinition.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1505,7 +1524,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-retrievefeature.html b/1.1/protocol-examples-retrievefeature.html
index 3f5d0bc..2f615ad 100644
--- a/1.1/protocol-examples-retrievefeature.html
+++ b/1.1/protocol-examples-retrievefeature.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1510,7 +1529,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-retrievefeatures.html b/1.1/protocol-examples-retrievefeatures.html
index 1a94a1a..d54d0ef 100644
--- a/1.1/protocol-examples-retrievefeatures.html
+++ b/1.1/protocol-examples-retrievefeatures.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1512,7 +1531,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-retrieveproperties.html b/1.1/protocol-examples-retrieveproperties.html
index 20fdccf..2592937 100644
--- a/1.1/protocol-examples-retrieveproperties.html
+++ b/1.1/protocol-examples-retrieveproperties.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1508,7 +1527,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-retrieveproperty.html b/1.1/protocol-examples-retrieveproperty.html
index 3953027..634daff 100644
--- a/1.1/protocol-examples-retrieveproperty.html
+++ b/1.1/protocol-examples-retrieveproperty.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1503,7 +1522,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-retrievething.html b/1.1/protocol-examples-retrievething.html
index 995a84c..c5cb40c 100644
--- a/1.1/protocol-examples-retrievething.html
+++ b/1.1/protocol-examples-retrievething.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1532,7 +1551,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-retrievethingdefinition.html b/1.1/protocol-examples-retrievethingdefinition.html
index b55d6d3..3611740 100644
--- a/1.1/protocol-examples-retrievethingdefinition.html
+++ b/1.1/protocol-examples-retrievethingdefinition.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1503,7 +1522,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-retrievethings.html b/1.1/protocol-examples-retrievethings.html
index 17830d6..c0b9fb3 100644
--- a/1.1/protocol-examples-retrievethings.html
+++ b/1.1/protocol-examples-retrievethings.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1529,7 +1548,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples-search.html b/1.1/protocol-examples-search.html
index bbd5e28..85604ff 100644
--- a/1.1/protocol-examples-search.html
+++ b/1.1/protocol-examples-search.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1607,7 +1626,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-examples.html b/1.1/protocol-examples.html
index 9dada3a..352d4ff 100644
--- a/1.1/protocol-examples.html
+++ b/1.1/protocol-examples.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1589,7 +1608,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-overview.html b/1.1/protocol-overview.html
index 40e3021..7e266c8 100644
--- a/1.1/protocol-overview.html
+++ b/1.1/protocol-overview.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1505,7 +1524,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-specification-acks.html b/1.1/protocol-specification-acks.html
index 508e946..e19aaa8 100644
--- a/1.1/protocol-specification-acks.html
+++ b/1.1/protocol-specification-acks.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1529,7 +1548,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-specification-policies-create-or-modify.html b/1.1/protocol-specification-policies-create-or-modify.html
index 83b1be9..a42e9d0 100644
--- a/1.1/protocol-specification-policies-create-or-modify.html
+++ b/1.1/protocol-specification-policies-create-or-modify.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -2107,7 +2126,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-specification-policies-delete.html b/1.1/protocol-specification-policies-delete.html
index 454dcf0..b86d89d 100644
--- a/1.1/protocol-specification-policies-delete.html
+++ b/1.1/protocol-specification-policies-delete.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1777,7 +1796,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-specification-policies-retrieve.html b/1.1/protocol-specification-policies-retrieve.html
index ad9fb32..11cf9a0 100644
--- a/1.1/protocol-specification-policies-retrieve.html
+++ b/1.1/protocol-specification-policies-retrieve.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -2000,7 +2019,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-specification-policies.html b/1.1/protocol-specification-policies.html
index 78808b0..550fed0 100644
--- a/1.1/protocol-specification-policies.html
+++ b/1.1/protocol-specification-policies.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1587,7 +1606,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-specification-things-create-or-modify.html b/1.1/protocol-specification-things-create-or-modify.html
index 23e6556..325b41e 100644
--- a/1.1/protocol-specification-things-create-or-modify.html
+++ b/1.1/protocol-specification-things-create-or-modify.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -2907,7 +2926,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-specification-things-delete.html b/1.1/protocol-specification-things-delete.html
index 9d02f44..70db547 100644
--- a/1.1/protocol-specification-things-delete.html
+++ b/1.1/protocol-specification-things-delete.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -2394,7 +2413,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-specification-things-messages.html b/1.1/protocol-specification-things-messages.html
index d88d424..a6b943e 100644
--- a/1.1/protocol-specification-things-messages.html
+++ b/1.1/protocol-specification-things-messages.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1749,7 +1768,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-specification-things-retrieve.html b/1.1/protocol-specification-things-retrieve.html
index a36fd6e..4c9eca2 100644
--- a/1.1/protocol-specification-things-retrieve.html
+++ b/1.1/protocol-specification-things-retrieve.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -2196,7 +2215,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-specification-things-search.html b/1.1/protocol-specification-things-search.html
index 924654c..42ed1f6 100644
--- a/1.1/protocol-specification-things-search.html
+++ b/1.1/protocol-specification-things-search.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1853,7 +1872,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-specification-things.html b/1.1/protocol-specification-things.html
index 330a8e6..f05a1c0 100644
--- a/1.1/protocol-specification-things.html
+++ b/1.1/protocol-specification-things.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1558,7 +1577,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-specification-topic.html b/1.1/protocol-specification-topic.html
index 6639dc4..1c2a76a 100644
--- a/1.1/protocol-specification-topic.html
+++ b/1.1/protocol-specification-topic.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1663,7 +1682,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-specification.html b/1.1/protocol-specification.html
index 67d4a07..583f527 100644
--- a/1.1/protocol-specification.html
+++ b/1.1/protocol-specification.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1645,7 +1664,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/protocol-twinlive.html b/1.1/protocol-twinlive.html
index b10fa2c..2ee2615 100644
--- a/1.1/protocol-twinlive.html
+++ b/1.1/protocol-twinlive.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1516,7 +1535,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/release_notes_010-M1.html b/1.1/release_notes_010-M1.html
index 11d74d1..7d5bed4 100644
--- a/1.1/release_notes_010-M1.html
+++ b/1.1/release_notes_010-M1.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1495,7 +1514,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/release_notes_010-M3.html b/1.1/release_notes_010-M3.html
index d18faf9..4fde1db 100644
--- a/1.1/release_notes_010-M3.html
+++ b/1.1/release_notes_010-M3.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1551,7 +1570,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/release_notes_020-M1.html b/1.1/release_notes_020-M1.html
index a347239..17dbb28 100644
--- a/1.1/release_notes_020-M1.html
+++ b/1.1/release_notes_020-M1.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1536,7 +1555,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/release_notes_030-M1.html b/1.1/release_notes_030-M1.html
index e34dc1f..b163d10 100644
--- a/1.1/release_notes_030-M1.html
+++ b/1.1/release_notes_030-M1.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1547,7 +1566,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/release_notes_030-M2.html b/1.1/release_notes_030-M2.html
index f5f7940..0a289c4 100644
--- a/1.1/release_notes_030-M2.html
+++ b/1.1/release_notes_030-M2.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1544,7 +1563,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/release_notes_080-M1.html b/1.1/release_notes_080-M1.html
index 763666e..1efbe41 100644
--- a/1.1/release_notes_080-M1.html
+++ b/1.1/release_notes_080-M1.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1566,7 +1585,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/release_notes_080-M2.html b/1.1/release_notes_080-M2.html
index 5a028d4..60470ea 100644
--- a/1.1/release_notes_080-M2.html
+++ b/1.1/release_notes_080-M2.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1550,7 +1569,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/release_notes_080-M3.html b/1.1/release_notes_080-M3.html
index e65a952..735c8d7 100644
--- a/1.1/release_notes_080-M3.html
+++ b/1.1/release_notes_080-M3.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1554,7 +1573,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/release_notes_080.html b/1.1/release_notes_080.html
index 94f7cc3..56599e3 100644
--- a/1.1/release_notes_080.html
+++ b/1.1/release_notes_080.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1560,7 +1579,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/release_notes_090-M1.html b/1.1/release_notes_090-M1.html
index 210120e..4dc07ef 100644
--- a/1.1/release_notes_090-M1.html
+++ b/1.1/release_notes_090-M1.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1532,7 +1551,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/release_notes_090-M2.html b/1.1/release_notes_090-M2.html
index f0b17f5..11566bd 100644
--- a/1.1/release_notes_090-M2.html
+++ b/1.1/release_notes_090-M2.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1533,7 +1552,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/release_notes_090.html b/1.1/release_notes_090.html
index 847b4f5..fa97a5a 100644
--- a/1.1/release_notes_090.html
+++ b/1.1/release_notes_090.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1590,7 +1609,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/release_notes_100-M1a.html b/1.1/release_notes_100-M1a.html
index 36c6cc5..5040d3c 100644
--- a/1.1/release_notes_100-M1a.html
+++ b/1.1/release_notes_100-M1a.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1551,7 +1570,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/release_notes_100-M2.html b/1.1/release_notes_100-M2.html
index 5c72f10..163c7f6 100644
--- a/1.1/release_notes_100-M2.html
+++ b/1.1/release_notes_100-M2.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1568,7 +1587,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/release_notes_100.html b/1.1/release_notes_100.html
index 641845e..617fd6d 100644
--- a/1.1/release_notes_100.html
+++ b/1.1/release_notes_100.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1473,7 +1492,7 @@
expressed are correct, licensing is valid and compatible, and that other issues have been uncovered and properly
investigated.”</p>
-<h2 id="whats-in-this-release">What’s in this release?</h2>
+<h2 id="changelog">Changelog</h2>
<p>Eclipse Ditto 1.0.0 focuses on the following areas:</p>
@@ -1486,22 +1505,20 @@
If you want to upgrade an existing Ditto installation to 1.0.0, the following database migration has to be done
before upgrading: <strong>Follow the steps documented in <a href="#migration-notes">the migration notes</a></strong>.</div>
-<h3 id="changelog">Changelog</h3>
-
<p>Compared to the latest milestone release <a href="release_notes_100-M2.html">1.0.0-M2</a>, the following changes, new features and
bugfixes were added.</p>
-<h4 id="changes">Changes</h4>
+<h3 id="changes">Changes</h3>
-<h5 id="remove-suffixed-collections"><a href="https://github.com/eclipse/ditto/issues/537">Remove suffixed collections</a></h5>
+<h4 id="remove-suffixed-collections"><a href="https://github.com/eclipse/ditto/issues/537">Remove suffixed collections</a></h4>
<p>We removed suffixed collection support from Things and Policies persistence.
These collections do not scale well with increased amount of namespaces and lead to massive problems with mongodb as
sharding can’t be used.</p>
-<h4 id="new-features">New features</h4>
+<h3 id="new-features">New features</h3>
-<h5 id="comprehensive-support-for-command-responses"><a href="https://github.com/eclipse/ditto/issues/540">Comprehensive support for command responses</a></h5>
+<h4 id="comprehensive-support-for-command-responses"><a href="https://github.com/eclipse/ditto/issues/540">Comprehensive support for command responses</a></h4>
<p>Adds the possibility to define a “reply target” for <a href="basic-connections.html#sources">connection sources</a> where</p>
<ul>
@@ -1515,19 +1532,19 @@
<p>Used in combination with <a href="https://eclipse.org/hono/">Eclipse Hono</a> it is possible to send responses to devices which
e.g. need to retrieve data from Ditto.</p>
-<h5 id="add-definition-to-thing-in-order-to-reference-used-model"><a href="https://github.com/eclipse/ditto/issues/247">Add “definition” to Thing in order to reference used model</a></h5>
+<h4 id="add-definition-to-thing-in-order-to-reference-used-model"><a href="https://github.com/eclipse/ditto/issues/247">Add “definition” to Thing in order to reference used model</a></h4>
<p>In order to specify which model a Thing follows, the JSON of the Thing entity was enhanced with a single string for
<code class="highlighter-rouge">"definintion"</code>. This can e.g. be used in order to place an <a href="https://eclipse.org/vorto/">Eclipse Vorto</a>
“Information Model” reference to a Thing.</p>
-<h4 id="bugfixes">Bugfixes</h4>
+<h3 id="bugfixes">Bugfixes</h3>
-<h5 id="fixed-nullpointer-in-streamingsessionactor"><a href="https://github.com/eclipse/ditto/pull/546">Fixed NullPointer in StreamingSessionActor</a></h5>
+<h4 id="fixed-nullpointer-in-streamingsessionactor"><a href="https://github.com/eclipse/ditto/pull/546">Fixed NullPointer in StreamingSessionActor</a></h4>
<p>When closing a WebSocket session, a <code class="highlighter-rouge">NullPointerException</code> occurred which is fixed now.</p>
-<h3 id="migration-notes">Migration notes</h3>
+<h2 id="migration-notes">Migration notes</h2>
<p>OpenID Connect URLs are now prefixed with <code class="highlighter-rouge">https://</code> per default. Any configured URLs containing <code class="highlighter-rouge">https://</code> will break the configuration.
Instead of <code class="highlighter-rouge">https://auth.eclipse.de/auth/realms/ditto</code> it has to be <code class="highlighter-rouge">auth.eclipse.de/auth/realms/ditto</code> instead.
@@ -1573,7 +1590,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/release_notes_110.html b/1.1/release_notes_110.html
index 752221c..9c6991c 100644
--- a/1.1/release_notes_110.html
+++ b/1.1/release_notes_110.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li class="active"><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1471,16 +1490,14 @@
<p>It is API and <a href="https://github.com/eclipse/ditto/blob/master/documentation/src/main/resources/architecture/DADR-0005-semantic-versioning.md">binary compatible</a>
to Eclipse Ditto 1.0.0.</p>
-<h2 id="whats-in-this-release">What’s in this release?</h2>
-
-<h3 id="changelog">Changelog</h3>
+<h2 id="changelog">Changelog</h2>
<p>Compared to the latest release <a href="release_notes_100.html">1.0.0</a>, the following changes, new features and
bugfixes were added.</p>
-<h4 id="changes">Changes</h4>
+<h3 id="changes">Changes</h3>
-<h5 id="java-11-as-runtime-environment"><a href="https://github.com/eclipse/ditto/issues/308">Java 11 as runtime environment</a></h5>
+<h4 id="java-11-as-runtime-environment"><a href="https://github.com/eclipse/ditto/issues/308">Java 11 as runtime environment</a></h4>
<p>The default Java runtime for Ditto’s Docker containers was switched from Java 8 to Java 11 which should have some
benefits in storing Strings in memory (this was already added in Java 9).</p>
@@ -1489,7 +1506,7 @@
for <a href="https://github.com/eclipse/ditto/blob/master/documentation/src/main/resources/architecture/DADR-0005-semantic-versioning.md">semantic versioning</a>
are still compatible to Java 8.</p>
-<h5 id="cbor-as-ditto-internal-serialization-provider"><a href="https://github.com/eclipse/ditto/pull/598">CBOR as Ditto internal serialization provider</a></h5>
+<h4 id="cbor-as-ditto-internal-serialization-provider"><a href="https://github.com/eclipse/ditto/pull/598">CBOR as Ditto internal serialization provider</a></h4>
<p>As a bachelor thesis, <a href="https://github.com/erikescher">Erik Escher</a> evaluated mechanisms to improve the serialization
overhead done in Ditto clusters.</p>
@@ -1498,15 +1515,15 @@
roundtrip times and throughput.
The Ditto team was happy to accept his pull request, again improving overall performance in Ditto.</p>
-<h5 id="more-strict-content-type-parsing-for-http-request-payload"><a href="https://github.com/eclipse/ditto/pull/650">More strict Content-Type parsing for HTTP request payload</a></h5>
+<h4 id="more-strict-content-type-parsing-for-http-request-payload"><a href="https://github.com/eclipse/ditto/pull/650">More strict Content-Type parsing for HTTP request payload</a></h4>
<p>In the past, Ditto did not evaluate the HTTP <code class="highlighter-rouge">Content-Type</code> header of HTTP requests sending along payload. As this
can be a potential security issue (e.g. in scope of CORS requests), the <code class="highlighter-rouge">Content-Type</code> is now strictly enforced to
be of <code class="highlighter-rouge">application/json</code> wherever Ditto only accepts JSON request payload.</p>
-<h4 id="new-features">New features</h4>
+<h3 id="new-features">New features</h3>
-<h5 id="management-of-policies-via-ditto-protocol-and-in-java-client"><a href="https://github.com/eclipse/ditto/issues/554">Management of policies via Ditto Protocol and in Java client</a></h5>
+<h4 id="management-of-policies-via-ditto-protocol-and-in-java-client"><a href="https://github.com/eclipse/ditto/issues/554">Management of policies via Ditto Protocol and in Java client</a></h4>
<p>The <a href="basic-policy.html">policy</a> entities can now - in addition to their HTTP API - be managed via the
<a href="protocol-specification-policies.html">Ditto Protocol</a>. That means also via
@@ -1515,7 +1532,7 @@
<p>APIs for <a href="client-sdk-java.html#manage-policies">policy management</a> were also added to the
<a href="https://github.com/eclipse/ditto-clients/pull/46">Ditto Java Client</a>.</p>
-<h5 id="searching-things-via-ditto-protocol-and-in-java-client"><a href="https://github.com/eclipse/ditto/issues/575">Searching things via Ditto Protocol and in Java client</a></h5>
+<h4 id="searching-things-via-ditto-protocol-and-in-java-client"><a href="https://github.com/eclipse/ditto/issues/575">Searching things via Ditto Protocol and in Java client</a></h4>
<p>New <a href="protocol-specification-things-search.html">Ditto Protocol for search</a> was added in order to define a search query
via the Ditto Protocol and also get results via an asynchronous channel. As a result, searching for things is now also
@@ -1525,7 +1542,7 @@
<p>APIs for <a href="client-sdk-java.html#search-for-things">searching things</a> were also added to the
<a href="https://github.com/eclipse/ditto-clients/pull/53">Ditto Java Client</a>.</p>
-<h5 id="enriching-messages-and-events-before-publishing-to-external-subscribers"><a href="https://github.com/eclipse/ditto/issues/561">Enriching messages and events before publishing to external subscribers</a></h5>
+<h4 id="enriching-messages-and-events-before-publishing-to-external-subscribers"><a href="https://github.com/eclipse/ditto/issues/561">Enriching messages and events before publishing to external subscribers</a></h4>
<p>When subscribing <a href="basic-changenotifications.html">change notifications</a> or for messages to publish to external system or
deliver via <a href="httpapi-protocol-bindings-websocket.html">WebSocket</a> it is now possible to <a href="basic-enrichment.html">enrich</a>
@@ -1537,7 +1554,7 @@
<p>APIs for <a href="client-sdk-java.html#subscribe-to-enriched-change-notifications">enriching changes</a> were also added to the
<a href="https://github.com/eclipse/ditto-clients/pull/43">Ditto Java Client</a>.</p>
-<h5 id="establish-connections-to-mqtt-5-brokers"><a href="https://github.com/eclipse/ditto/issues/561">Establish connections to MQTT 5 brokers</a></h5>
+<h4 id="establish-connections-to-mqtt-5-brokers"><a href="https://github.com/eclipse/ditto/issues/561">Establish connections to MQTT 5 brokers</a></h4>
<p>The Ditto community (namely <a href="https://github.com/w4tsn">Alexander Wellbrock (w4tsn)</a> from
<a href="https://www.othermo.de">othermo GmbH</a>) contributed MQTT 5 support to Ditto’s connectivity capabilities.<br />
@@ -1546,7 +1563,7 @@
<p>Thank you very much for this great contribution.</p>
-<h5 id="end-2-end-acknowledgements"><a href="https://github.com/eclipse/ditto/issues/611">End-2-end acknowledgements</a></h5>
+<h4 id="end-2-end-acknowledgements"><a href="https://github.com/eclipse/ditto/issues/611">End-2-end acknowledgements</a></h4>
<p>Until now, messages consumed by Eclipse Ditto were processed without a guarantee. That is being addressed with this
first feature addition, the model and logic in order to request and emit <a href="basic-acknowledgements.html">acknowledgements</a>.</p>
@@ -1558,15 +1575,15 @@
<p>APIs for <a href="client-sdk-java.html#request-and-issue-acknowledgements">requesting and issuing acknowledgements</a> were also
added to the <a href="https://github.com/eclipse/ditto-clients/pull/56">Ditto Java Client</a>.</p>
-<h5 id="pre-authenticated-authentication-mechanism"><a href="https://github.com/eclipse/ditto/issues/560">Pre-authenticated authentication mechanism</a></h5>
+<h4 id="pre-authenticated-authentication-mechanism"><a href="https://github.com/eclipse/ditto/issues/560">Pre-authenticated authentication mechanism</a></h4>
<p>Officially added+<a href="installation-operating.html#pre-authentication">documented</a> support of how Ditto external
authentication providers may be configured to authenticate users in Ditto by adding them as an HTTP reverse proxy in
front of Ditto.</p>
-<h4 id="deprecations">Deprecations</h4>
+<h3 id="deprecations">Deprecations</h3>
-<h5 id="api-version-1-deprecation"><a href="https://github.com/eclipse/ditto/pull/608">API version 1 deprecation</a></h5>
+<h4 id="api-version-1-deprecation"><a href="https://github.com/eclipse/ditto/pull/608">API version 1 deprecation</a></h4>
<p>Now that Ditto has a full replacement for <a href="basic-acl.html">ACLs</a>, namely <a href="basic-policy.html">policies</a> which now can
also be managed via the <a href="protocol-specification-policies.html">Ditto Protocol</a> and the
@@ -1579,13 +1596,13 @@
<p>So when you start using Ditto, please make sure to use API version <code class="highlighter-rouge">2</code> (using policies as
<a href="basic-auth.html#authorization">authorization mechanism</a>) from the very beginning.</p>
-<h4 id="bugfixes">Bugfixes</h4>
+<h3 id="bugfixes">Bugfixes</h3>
<p>Several bugs in Ditto 1.0.0 were fixed for 1.1.0.<br />
This is a complete list of the
<a href="https://github.com/eclipse/ditto/pulls?q=is%3Apr+milestone%3A1.1.0">merged pull requests</a>, including the fixed bugs.</p>
-<h3 id="migration-notes">Migration notes</h3>
+<h2 id="migration-notes">Migration notes</h2>
<p>Do not apply when updating from Eclipse Ditto 1.0.0 to 1.1.0.</p>
@@ -1614,7 +1631,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/release_notes_111.html b/1.1/release_notes_111.html
new file mode 100644
index 0000000..e022301
--- /dev/null
+++ b/1.1/release_notes_111.html
@@ -0,0 +1,1568 @@
+<!DOCTYPE html>
+<html>
+<head>
+ <meta charset="utf-8">
+<meta http-equiv="X-UA-Compatible" content="IE=edge">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="description" content="Version 1.1.1 of Eclipse Ditto, released on 11.05.2020">
+<meta name="keywords" content="release_notes, release notes, announcements, changelog">
+<title> Release notes 1.1.1 • Eclipse Ditto • a digital twin framework</title>
+
+<link rel="stylesheet" href="css/syntax.css">
+<link rel="stylesheet" type="text/css" href="//cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/modern-business.css">
+<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/customstyles.css">
+<link rel="stylesheet" href="css/boxshadowproperties.css">
+<link rel="stylesheet" href="css/theme-ditto.css">
+<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:400,700|Source+Code+Pro:300,600|Titillium+Web:400,600,700">
+
+<script src="//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.4/jquery.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/js/bootstrap.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/anchor-js/2.0.0/anchor.min.js" crossorigin="anonymous"></script>
+<script src="js/toc.js"></script>
+<script src="js/customscripts.js"></script>
+
+<script type="application/ld+json">
+{
+ "@context": "http://schema.org",
+ "@type": "Organization",
+ "url": "https://eclipse.org/ditto/",
+ "logo": "https://eclipse.org/ditto/images/ditto.svg"
+}
+</script>
+
+<link rel="icon" type="image/png" href="images/favicon-16x16.png" sizes="16x16">
+<link rel="icon" type="image/png" href="images/favicon-32x32.png" sizes="32x32">
+<link rel="icon" type="image/png" href="images/favicon-96x96.png" sizes="96x96">
+
+<link rel="alternate" type="application/rss+xml" title="Eclipse Ditto Blog" href="https://www.eclipse.org/ditto/feed.xml">
+
+<!-- Eclipse Foundation cookie consent: -->
+<link rel="stylesheet" type="text/css" href="//www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css" />
+<script src="//www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+ <script>
+ $(document).ready(function() {
+ $("#tg-sb-link").click(function() {
+ $("#tg-sb-sidebar").toggle();
+ $("#tg-sb-content").toggleClass('col-md-9');
+ $("#tg-sb-content").toggleClass('col-md-12');
+ $("#tg-sb-icon").toggleClass('fa-toggle-on');
+ $("#tg-sb-icon").toggleClass('fa-toggle-off');
+ });
+ });
+ </script>
+</head>
+
+
+<script>
+ (function(w,d,s,l,i){
+ w[l]=w[l]||[];
+ w[l].push({'gtm.start':
+ new Date().getTime(),event:'gtm.js'});
+ var f=d.getElementsByTagName(s)[0],
+ j=d.createElement(s),
+ dl=l!='dataLayer'?'&l='+l:'';
+ j.async=true;
+ j.src='https://www.googletagmanager.com/gtm.js?id='+i+dl;
+ f.parentNode.insertBefore(j,f);
+ })(window,document,'script','dataLayer','GTM-5WLCZXC');
+</script>
+
+
+
+<body>
+<!-- Navigation -->
+<nav class="navbar navbar-inverse navbar-fixed-top">
+ <div class="container topnavlinks">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-ditto-home" href="index.html"> <img src="images/ditto_allwhite_symbolonly.svg" class="ditto-navbar-symbol" alt="Home"> <img src="images/ditto_allwhite_textonly.svg" class="ditto-navbar-symbol-text" alt="Ditto"></a>
+ </div>
+ <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
+ <ul class="nav navbar-nav navbar-right">
+ <!-- toggle sidebar button -->
+ <!--<li><a id="tg-sb-link" href="#"><i id="tg-sb-icon" class="fa fa-toggle-on"></i> Nav</a></li>-->
+ <!-- entries without drop-downs appear here -->
+
+
+
+
+
+
+
+ <li><a href="blog.html">Blog</a></li>
+
+
+
+ <li><a href="intro-overview.html">Documentation</a></li>
+
+
+
+ <li><a href="http-api-doc.html">HTTP API</a></li>
+
+
+
+ <li><a href="https://ditto.eclipse.org" target="_blank">Sandbox</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">GitHub</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">GitHub examples</a></li>
+
+
+
+ <!-- entries with drop-downs appear here -->
+ <!-- conditional logic to control which topnav appears for the audience defined in the configuration file.-->
+
+
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Links<b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+
+ <li><a href="https://projects.eclipse.org/projects/iot.ditto" target="_blank">Eclipse Ditto Project</a></li>
+
+
+
+ <li><a href="https://www.eclipse.org/forums/index.php/f/364/" target="_blank">Forum</a></li>
+
+
+
+ <li><a href="https://ci.eclipse.org/ditto/" target="_blank">Jenkins</a></li>
+
+
+
+ <li><a href="https://dev.eclipse.org/mhonarc/lists/ditto-dev/" target="_blank">Mailing list archives</a></li>
+
+
+
+ <li><a href="https://gitter.im/eclipse/ditto" target="_blank">Gitter.im chat</a></li>
+
+
+ </ul>
+ </li>
+
+
+
+ <!--comment out this block if you want to hide search-->
+ <li>
+ <!--start search-->
+ <div id="search-demo-container">
+ <input type="text" id="search-input" placeholder="search...">
+ <ul id="results-container"></ul>
+ </div>
+ <script src="//cdnjs.cloudflare.com/ajax/libs/simple-jekyll-search/0.0.9/jekyll-search.js" type="text/javascript"></script>
+ <script type="text/javascript">
+ SimpleJekyllSearch.init({
+ searchInput: document.getElementById('search-input'),
+ resultsContainer: document.getElementById('results-container'),
+ dataSource: 'search.json',
+ searchResultTemplate: '<li><a href="{url}" title="Release notes 1.1.1">{title}</a></li>',
+ noResultsText: 'No results found.',
+ limit: 10,
+ fuzzy: true,
+ })
+ </script>
+ <!--end search-->
+ </li>
+ </ul>
+ </div>
+ </div>
+ <!-- /.container -->
+</nav>
+
+<!-- Page Content -->
+<div class="container">
+ <div id="main">
+ <!-- Content Row -->
+ <div class="row">
+
+
+ <!-- Sidebar Column -->
+ <div class="col-md-3" id="tg-sb-sidebar">
+
+
+<ul id="mysidebar" class="nav">
+ <li class="sidebarTitle">
+ <label for="docVersion">Eclipse Ditto version:</label>
+ <div class="select-wrapper">
+ <select id="docVersion" name="docVersion">
+
+ <option value="">development</option>
+
+ <option value="1.0">1.0</option>
+
+ <option value="1.1">1.1</option>
+
+ </select>
+ </div>
+ <div id="dev-warning">
+ <div markdown="span" class="alert alert-warning" role="alert" style="font-size:0.6em"><i class="fa fa-warning"></i> <b>Important:</b> This documentation reflects the latest 'development'. You might want to choose a released version.</div>
+ </div>
+ </li>
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Introduction</a>
+ <ul>
+
+
+
+ <li><a href="intro-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="intro-digitaltwins.html">Digital twins</a></li>
+
+
+
+
+
+
+ <li><a href="intro-hello-world.html">Hello world</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Release Notes</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li class="active"><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_100.html">1.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_090.html">0.9.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_080.html">0.8.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Milestone releases</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_100-M2.html">1.0.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_100-M1a.html">1.0.0-M1a</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M2.html">0.9.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M1.html">0.9.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M3.html">0.8.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M2.html">0.8.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M1.html">0.8.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M2.html">0.3.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M1.html">0.3.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_020-M1.html">0.2.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M3.html">0.1.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M1.html">0.1.0-M1</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Installation</a>
+ <ul>
+
+
+
+ <li><a href="installation-building.html">Building Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-running.html">Running Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-operating.html">Operating Ditto</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Basic concepts</a>
+ <ul>
+
+
+
+ <li><a href="basic-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Model entities</a>
+ <ul>
+
+
+
+ <li><a href="basic-thing.html">Thing</a></li>
+
+
+
+
+
+ <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
+
+
+
+
+
+ <li><a href="basic-feature.html">Feature</a></li>
+
+
+
+
+
+ <li><a href="basic-policy.html">Policy</a></li>
+
+
+
+
+
+ <li><a href="basic-namespaces-and-names.html">Namespaces and Names</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-auth.html">Authentication and Authorization</a></li>
+
+
+
+
+
+
+ <li><a href="basic-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="basic-signals.html">Signals</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Signal types</a>
+ <ul>
+
+
+
+ <li><a href="basic-signals-command.html">Command</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-commandresponse.html">Command response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-errorresponse.html">Error response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-event.html">Event</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-apis.html">APIs</a></li>
+
+
+
+
+
+
+ <li><a href="basic-connections.html">Connections</a></li>
+
+
+
+
+
+
+ <li><a href="basic-placeholders.html">Placeholders</a></li>
+
+
+
+
+
+
+ <li><a href="basic-changenotifications.html">Change notifications</a></li>
+
+
+
+
+
+
+ <li><a href="basic-rql.html">RQL expressions</a></li>
+
+
+
+
+
+
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
+ <li><a href="basic-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Architecture</a>
+ <ul>
+
+
+
+ <li><a href="architecture-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Services</a>
+ <ul>
+
+
+
+ <li><a href="architecture-services-policies.html">Policies</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things.html">Things</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things-search.html">Things-Search</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-connectivity.html">Connectivity</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-concierge.html">Concierge</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-gateway.html">Gateway</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>HTTP API</a>
+ <ul>
+
+
+
+ <li><a href="httpapi-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-concepts.html">Concepts</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-protocol-bindings-websocket.html">WebSocket protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-sse.html">Server sent events</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Connectivity API</a>
+ <ul>
+
+
+
+ <li><a href="connectivity-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-manage-connections.html">Manage connections</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp091.html">AMQP 0.9.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp10.html">AMQP 1.0 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-kafka2.html">Kafka 2.x protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-mapping.html">Payload mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-header-mapping.html">Header mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-tls-certificates.html">TLS certificates</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Client SDK</a>
+ <ul>
+
+
+
+ <li><a href="client-sdk-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-java.html">Java</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-javascript.html">JavaScript</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Ditto Protocol</a>
+ <ul>
+
+
+
+ <li><a href="protocol-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-twinlive.html">Twin/live channel</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification.html">Specification</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-topic.html">Protocol topic</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-things.html">Things group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-delete.html">Delete</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ search/messages</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-search.html">Search</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-messages.html">Messages</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-bindings.html">Bindings</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-examples.html">Examples</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-creatething.html">Create a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletething.html">Delete a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifything.html">Modify a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievething.html">Retrieve a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethings.html">Retrieve multiple Things</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattributes.html">Delete Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattributes.html">Modify Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattributes.html">Retrieve Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattribute.html">Create a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattribute.html">Delete a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattribute.html">Modify a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattribute.html">Retrieve a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createthingdefinition.html">Create a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletethingdefinition.html">Delete a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifythingdefinition.html">Modify a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethingdefinition.html">Retrieve a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeatures.html">Create Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeatures.html">Delete Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeatures.html">Modify Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeatures.html">Retrieve Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeature.html">Create a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeature.html">Delete a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeature.html">Modify a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeature.html">Retrieve a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdefinition.html">Create Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedefinition.html">Delete Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydefinition.html">Modify Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedefinition.html">Retrieve Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperties.html">Create Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperties.html">Delete Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperties.html">Modify Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperties.html">Retrieve Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperty.html">Create a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperty.html">Delete a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperty.html">Modify a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperty.html">Retrieve a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li><a href="sandbox.html">Sandbox</a></li>
+
+
+
+
+
+ <li><a href="presentations.html">Presentations</a></li>
+
+
+
+
+
+ <li><a href="glossary.html">Glossary</a></li>
+
+
+
+
+
+ <li><a href="feedback.html">Feedback</a></li>
+
+
+
+
+
+ <p class="external">
+ <a href="#" id="collapseAll">Collapse All</a> | <a href="#" id="expandAll">Expand All</a>
+ </p>
+
+</ul>
+
+<!-- this highlights the active parent class in the sidebar. this is critical so that the parent expands when you're viewing a page. This must appear below the sidebar code above. Otherwise, if placed inside customscripts.js, the script runs before the sidebar code runs and the class never gets inserted.-->
+<script>$("li.active").parents('li').toggleClass("active");
+
+$(function() {
+ $("#dev-warning").hide();
+ changeSelectedDocVersionDropdownSelection($("#docVersion")[0]);
+ $("#docVersion").change(changeSelectedDocVersion);
+});
+
+function changeSelectedDocVersionDropdownSelection(element) {
+ var pathName = window.location.pathname;
+
+ var versionOptions = element.options;
+ for (var i = 0; i < versionOptions.length; i++) {
+ var versionValue = versionOptions[i].value;
+ if ((versionValue !== "") && pathName.startsWith("/ditto/"+versionValue+"/")) {
+ $("#docVersion").val(versionValue).change();
+ return;
+ }
+ }
+ // fallback: dev with "empty" version value:
+ $("#docVersion").val("").change();
+ $("#dev-warning").show();
+}
+function changeSelectedDocVersion() {
+ var versionValue = $('#docVersion').val();
+ var remainingPath = window.location.pathname.replace("/ditto/", "");
+ var versionMatch = remainingPath.match("([0-9].[0.9])/(.*)");
+ if (versionValue === "" && !versionMatch) {
+ // do nothing, we're already on the correct "dev" version
+ } else if (versionMatch && (versionValue === versionMatch[1])) {
+ // do nothing, we're already on the correct version
+ } else {
+ if (versionValue === "" && versionMatch) {
+ window.location.pathname = "ditto/" + versionMatch[2];
+ } else if (versionValue === "") {
+ window.location.pathname = "ditto/" + remainingPath;
+ } else if (versionMatch) {
+ window.location.pathname = "ditto/" + versionValue + "/" + versionMatch[2];
+ } else {
+ window.location.pathname = "ditto/" + versionValue + "/" + remainingPath;
+ }
+ }
+}
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Release notes 1.1.1</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+ <div class="summary">Version 1.1.1 of Eclipse Ditto, released on 11.05.2020</div>
+
+
+
+
+<!-- this handles the automatic toc. use ## for subheads to auto-generate the on-page minitoc. if you use html tags, you must supply an ID for the heading element in order for it to appear in the minitoc. -->
+<script>
+$( document ).ready(function() {
+ // Handler for .ready() called.
+
+$('#toc').toc({ minimumHeaders: 0, listType: 'ul', showSpeed: 0, headers: 'h2,h3,h4' });
+
+/* this offset helps account for the space taken up by the floating toolbar. */
+$('#toc').on('click', 'a', function() {
+ var target = $(this.getAttribute('href'))
+ , scroll_target = target.offset().top
+
+ $(window).scrollTop(scroll_target - 10);
+ return false
+})
+
+});
+</script>
+
+<div id="toc"></div>
+
+
+
+
+
+
+
+
+
+ <p>This is a bugfix release needed for the Ditto Java SDK, no new features since <a href="release_notes_110.html">1.1.0</a> were added.</p>
+
+<h2 id="changelog">Changelog</h2>
+
+<p>Compared to the latest release <a href="release_notes_110.html">1.1.0</a>, the following bugfixes were added.</p>
+
+<h3 id="bugfixes">Bugfixes</h3>
+
+<p>This is a complete list of the
+<a href="https://github.com/eclipse/ditto/pulls?q=is%3Apr+milestone%3A1.1.1">merged pull requests</a>, including the fixed bugs.</p>
+
+<h4 id="allow-to-respond-to-live-messages-via-ditto-client"><a href="https://github.com/eclipse/ditto-clients/pull/60">Allow to respond to live messages via ditto client</a></h4>
+
+<p>Don’t force response-required to be false when calling send() without response consumer.</p>
+
+<h4 id="header-mapping"><a href="https://github.com/eclipse/ditto/pull/671">Header mapping</a></h4>
+
+<p>Remove filtering of unknown headers for adaptables. We need those headers for header mapping in connectivity.</p>
+
+
+ <div class="tags">
+
+ <b>Tags: </b>
+
+
+
+ <a href="tag_release_notes.html" class="btn btn-default navbar-btn cursorNorm" role="button">release_notes</a>
+
+
+
+ </div>
+
+</div>
+
+<hr class="shaded"/>
+
+<footer>
+ <div class="row">
+ <div class="col-lg-12 footer">
+ <div class="logo">
+ <a href="https://eclipse.org"><img src="images/eclipse_foundation_logo.svg" alt="Eclipse logo"/></a>
+ </div>
+ <p class="notice">
+ ©2020 Eclipse Ditto.
+ Site last generated: Jul 1, 2020 <br />
+ </p>
+ <div class="quickLinks">
+ <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
+ > Privacy Policy
+ </a>
+ <a href="https://www.eclipse.org/legal/termsofuse.php" target="_blank">
+ > Terms of Use
+ </a>
+ <a href="https://www.eclipse.org/legal/copyright.php" target="_blank">
+ > Copyright Agent
+ </a>
+ <a href="https://www.eclipse.org/legal" target="_blank">
+ > Legal
+ </a>
+ <a href="https://www.eclipse.org/legal/epl-2.0/" target="_blank">
+ > License
+ </a>
+ <a href="https://eclipse.org/security" target="_blank">
+ > Report a Vulnerability
+ </a>
+ </div>
+ </div>
+ </div>
+</footer>
+
+
+ </div>
+ <!-- /.row -->
+</div>
+<!-- /.container -->
+</div>
+<!-- /#main -->
+ </div>
+
+</body>
+</html>
diff --git a/1.1/release_notes_112.html b/1.1/release_notes_112.html
new file mode 100644
index 0000000..0b99f24
--- /dev/null
+++ b/1.1/release_notes_112.html
@@ -0,0 +1,1584 @@
+<!DOCTYPE html>
+<html>
+<head>
+ <meta charset="utf-8">
+<meta http-equiv="X-UA-Compatible" content="IE=edge">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="description" content="Version 1.1.2 of Eclipse Ditto, released on 01.07.2020">
+<meta name="keywords" content="release_notes, release notes, announcements, changelog">
+<title> Release notes 1.1.2 • Eclipse Ditto • a digital twin framework</title>
+
+<link rel="stylesheet" href="css/syntax.css">
+<link rel="stylesheet" type="text/css" href="//cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/modern-business.css">
+<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/customstyles.css">
+<link rel="stylesheet" href="css/boxshadowproperties.css">
+<link rel="stylesheet" href="css/theme-ditto.css">
+<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:400,700|Source+Code+Pro:300,600|Titillium+Web:400,600,700">
+
+<script src="//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.4/jquery.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/js/bootstrap.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/anchor-js/2.0.0/anchor.min.js" crossorigin="anonymous"></script>
+<script src="js/toc.js"></script>
+<script src="js/customscripts.js"></script>
+
+<script type="application/ld+json">
+{
+ "@context": "http://schema.org",
+ "@type": "Organization",
+ "url": "https://eclipse.org/ditto/",
+ "logo": "https://eclipse.org/ditto/images/ditto.svg"
+}
+</script>
+
+<link rel="icon" type="image/png" href="images/favicon-16x16.png" sizes="16x16">
+<link rel="icon" type="image/png" href="images/favicon-32x32.png" sizes="32x32">
+<link rel="icon" type="image/png" href="images/favicon-96x96.png" sizes="96x96">
+
+<link rel="alternate" type="application/rss+xml" title="Eclipse Ditto Blog" href="https://www.eclipse.org/ditto/feed.xml">
+
+<!-- Eclipse Foundation cookie consent: -->
+<link rel="stylesheet" type="text/css" href="//www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css" />
+<script src="//www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+ <script>
+ $(document).ready(function() {
+ $("#tg-sb-link").click(function() {
+ $("#tg-sb-sidebar").toggle();
+ $("#tg-sb-content").toggleClass('col-md-9');
+ $("#tg-sb-content").toggleClass('col-md-12');
+ $("#tg-sb-icon").toggleClass('fa-toggle-on');
+ $("#tg-sb-icon").toggleClass('fa-toggle-off');
+ });
+ });
+ </script>
+</head>
+
+
+<script>
+ (function(w,d,s,l,i){
+ w[l]=w[l]||[];
+ w[l].push({'gtm.start':
+ new Date().getTime(),event:'gtm.js'});
+ var f=d.getElementsByTagName(s)[0],
+ j=d.createElement(s),
+ dl=l!='dataLayer'?'&l='+l:'';
+ j.async=true;
+ j.src='https://www.googletagmanager.com/gtm.js?id='+i+dl;
+ f.parentNode.insertBefore(j,f);
+ })(window,document,'script','dataLayer','GTM-5WLCZXC');
+</script>
+
+
+
+<body>
+<!-- Navigation -->
+<nav class="navbar navbar-inverse navbar-fixed-top">
+ <div class="container topnavlinks">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-ditto-home" href="index.html"> <img src="images/ditto_allwhite_symbolonly.svg" class="ditto-navbar-symbol" alt="Home"> <img src="images/ditto_allwhite_textonly.svg" class="ditto-navbar-symbol-text" alt="Ditto"></a>
+ </div>
+ <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
+ <ul class="nav navbar-nav navbar-right">
+ <!-- toggle sidebar button -->
+ <!--<li><a id="tg-sb-link" href="#"><i id="tg-sb-icon" class="fa fa-toggle-on"></i> Nav</a></li>-->
+ <!-- entries without drop-downs appear here -->
+
+
+
+
+
+
+
+ <li><a href="blog.html">Blog</a></li>
+
+
+
+ <li><a href="intro-overview.html">Documentation</a></li>
+
+
+
+ <li><a href="http-api-doc.html">HTTP API</a></li>
+
+
+
+ <li><a href="https://ditto.eclipse.org" target="_blank">Sandbox</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">GitHub</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">GitHub examples</a></li>
+
+
+
+ <!-- entries with drop-downs appear here -->
+ <!-- conditional logic to control which topnav appears for the audience defined in the configuration file.-->
+
+
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Links<b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+
+ <li><a href="https://projects.eclipse.org/projects/iot.ditto" target="_blank">Eclipse Ditto Project</a></li>
+
+
+
+ <li><a href="https://www.eclipse.org/forums/index.php/f/364/" target="_blank">Forum</a></li>
+
+
+
+ <li><a href="https://ci.eclipse.org/ditto/" target="_blank">Jenkins</a></li>
+
+
+
+ <li><a href="https://dev.eclipse.org/mhonarc/lists/ditto-dev/" target="_blank">Mailing list archives</a></li>
+
+
+
+ <li><a href="https://gitter.im/eclipse/ditto" target="_blank">Gitter.im chat</a></li>
+
+
+ </ul>
+ </li>
+
+
+
+ <!--comment out this block if you want to hide search-->
+ <li>
+ <!--start search-->
+ <div id="search-demo-container">
+ <input type="text" id="search-input" placeholder="search...">
+ <ul id="results-container"></ul>
+ </div>
+ <script src="//cdnjs.cloudflare.com/ajax/libs/simple-jekyll-search/0.0.9/jekyll-search.js" type="text/javascript"></script>
+ <script type="text/javascript">
+ SimpleJekyllSearch.init({
+ searchInput: document.getElementById('search-input'),
+ resultsContainer: document.getElementById('results-container'),
+ dataSource: 'search.json',
+ searchResultTemplate: '<li><a href="{url}" title="Release notes 1.1.2">{title}</a></li>',
+ noResultsText: 'No results found.',
+ limit: 10,
+ fuzzy: true,
+ })
+ </script>
+ <!--end search-->
+ </li>
+ </ul>
+ </div>
+ </div>
+ <!-- /.container -->
+</nav>
+
+<!-- Page Content -->
+<div class="container">
+ <div id="main">
+ <!-- Content Row -->
+ <div class="row">
+
+
+ <!-- Sidebar Column -->
+ <div class="col-md-3" id="tg-sb-sidebar">
+
+
+<ul id="mysidebar" class="nav">
+ <li class="sidebarTitle">
+ <label for="docVersion">Eclipse Ditto version:</label>
+ <div class="select-wrapper">
+ <select id="docVersion" name="docVersion">
+
+ <option value="">development</option>
+
+ <option value="1.0">1.0</option>
+
+ <option value="1.1">1.1</option>
+
+ </select>
+ </div>
+ <div id="dev-warning">
+ <div markdown="span" class="alert alert-warning" role="alert" style="font-size:0.6em"><i class="fa fa-warning"></i> <b>Important:</b> This documentation reflects the latest 'development'. You might want to choose a released version.</div>
+ </div>
+ </li>
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Introduction</a>
+ <ul>
+
+
+
+ <li><a href="intro-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="intro-digitaltwins.html">Digital twins</a></li>
+
+
+
+
+
+
+ <li><a href="intro-hello-world.html">Hello world</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Release Notes</a>
+ <ul>
+
+
+
+ <li class="active"><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_100.html">1.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_090.html">0.9.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_080.html">0.8.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Milestone releases</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_100-M2.html">1.0.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_100-M1a.html">1.0.0-M1a</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M2.html">0.9.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M1.html">0.9.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M3.html">0.8.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M2.html">0.8.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M1.html">0.8.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M2.html">0.3.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M1.html">0.3.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_020-M1.html">0.2.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M3.html">0.1.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M1.html">0.1.0-M1</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Installation</a>
+ <ul>
+
+
+
+ <li><a href="installation-building.html">Building Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-running.html">Running Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-operating.html">Operating Ditto</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Basic concepts</a>
+ <ul>
+
+
+
+ <li><a href="basic-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Model entities</a>
+ <ul>
+
+
+
+ <li><a href="basic-thing.html">Thing</a></li>
+
+
+
+
+
+ <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
+
+
+
+
+
+ <li><a href="basic-feature.html">Feature</a></li>
+
+
+
+
+
+ <li><a href="basic-policy.html">Policy</a></li>
+
+
+
+
+
+ <li><a href="basic-namespaces-and-names.html">Namespaces and Names</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-auth.html">Authentication and Authorization</a></li>
+
+
+
+
+
+
+ <li><a href="basic-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="basic-signals.html">Signals</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Signal types</a>
+ <ul>
+
+
+
+ <li><a href="basic-signals-command.html">Command</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-commandresponse.html">Command response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-errorresponse.html">Error response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-event.html">Event</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-apis.html">APIs</a></li>
+
+
+
+
+
+
+ <li><a href="basic-connections.html">Connections</a></li>
+
+
+
+
+
+
+ <li><a href="basic-placeholders.html">Placeholders</a></li>
+
+
+
+
+
+
+ <li><a href="basic-changenotifications.html">Change notifications</a></li>
+
+
+
+
+
+
+ <li><a href="basic-rql.html">RQL expressions</a></li>
+
+
+
+
+
+
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
+ <li><a href="basic-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Architecture</a>
+ <ul>
+
+
+
+ <li><a href="architecture-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Services</a>
+ <ul>
+
+
+
+ <li><a href="architecture-services-policies.html">Policies</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things.html">Things</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things-search.html">Things-Search</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-connectivity.html">Connectivity</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-concierge.html">Concierge</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-gateway.html">Gateway</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>HTTP API</a>
+ <ul>
+
+
+
+ <li><a href="httpapi-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-concepts.html">Concepts</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-protocol-bindings-websocket.html">WebSocket protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-sse.html">Server sent events</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Connectivity API</a>
+ <ul>
+
+
+
+ <li><a href="connectivity-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-manage-connections.html">Manage connections</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp091.html">AMQP 0.9.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp10.html">AMQP 1.0 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-kafka2.html">Kafka 2.x protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-mapping.html">Payload mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-header-mapping.html">Header mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-tls-certificates.html">TLS certificates</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Client SDK</a>
+ <ul>
+
+
+
+ <li><a href="client-sdk-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-java.html">Java</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-javascript.html">JavaScript</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Ditto Protocol</a>
+ <ul>
+
+
+
+ <li><a href="protocol-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-twinlive.html">Twin/live channel</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification.html">Specification</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-topic.html">Protocol topic</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-things.html">Things group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-delete.html">Delete</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ search/messages</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-search.html">Search</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-messages.html">Messages</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-bindings.html">Bindings</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-examples.html">Examples</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-creatething.html">Create a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletething.html">Delete a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifything.html">Modify a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievething.html">Retrieve a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethings.html">Retrieve multiple Things</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattributes.html">Delete Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattributes.html">Modify Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattributes.html">Retrieve Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattribute.html">Create a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattribute.html">Delete a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattribute.html">Modify a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattribute.html">Retrieve a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createthingdefinition.html">Create a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletethingdefinition.html">Delete a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifythingdefinition.html">Modify a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethingdefinition.html">Retrieve a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeatures.html">Create Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeatures.html">Delete Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeatures.html">Modify Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeatures.html">Retrieve Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeature.html">Create a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeature.html">Delete a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeature.html">Modify a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeature.html">Retrieve a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdefinition.html">Create Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedefinition.html">Delete Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydefinition.html">Modify Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedefinition.html">Retrieve Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperties.html">Create Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperties.html">Delete Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperties.html">Modify Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperties.html">Retrieve Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperty.html">Create a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperty.html">Delete a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperty.html">Modify a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperty.html">Retrieve a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li><a href="sandbox.html">Sandbox</a></li>
+
+
+
+
+
+ <li><a href="presentations.html">Presentations</a></li>
+
+
+
+
+
+ <li><a href="glossary.html">Glossary</a></li>
+
+
+
+
+
+ <li><a href="feedback.html">Feedback</a></li>
+
+
+
+
+
+ <p class="external">
+ <a href="#" id="collapseAll">Collapse All</a> | <a href="#" id="expandAll">Expand All</a>
+ </p>
+
+</ul>
+
+<!-- this highlights the active parent class in the sidebar. this is critical so that the parent expands when you're viewing a page. This must appear below the sidebar code above. Otherwise, if placed inside customscripts.js, the script runs before the sidebar code runs and the class never gets inserted.-->
+<script>$("li.active").parents('li').toggleClass("active");
+
+$(function() {
+ $("#dev-warning").hide();
+ changeSelectedDocVersionDropdownSelection($("#docVersion")[0]);
+ $("#docVersion").change(changeSelectedDocVersion);
+});
+
+function changeSelectedDocVersionDropdownSelection(element) {
+ var pathName = window.location.pathname;
+
+ var versionOptions = element.options;
+ for (var i = 0; i < versionOptions.length; i++) {
+ var versionValue = versionOptions[i].value;
+ if ((versionValue !== "") && pathName.startsWith("/ditto/"+versionValue+"/")) {
+ $("#docVersion").val(versionValue).change();
+ return;
+ }
+ }
+ // fallback: dev with "empty" version value:
+ $("#docVersion").val("").change();
+ $("#dev-warning").show();
+}
+function changeSelectedDocVersion() {
+ var versionValue = $('#docVersion').val();
+ var remainingPath = window.location.pathname.replace("/ditto/", "");
+ var versionMatch = remainingPath.match("([0-9].[0.9])/(.*)");
+ if (versionValue === "" && !versionMatch) {
+ // do nothing, we're already on the correct "dev" version
+ } else if (versionMatch && (versionValue === versionMatch[1])) {
+ // do nothing, we're already on the correct version
+ } else {
+ if (versionValue === "" && versionMatch) {
+ window.location.pathname = "ditto/" + versionMatch[2];
+ } else if (versionValue === "") {
+ window.location.pathname = "ditto/" + remainingPath;
+ } else if (versionMatch) {
+ window.location.pathname = "ditto/" + versionValue + "/" + versionMatch[2];
+ } else {
+ window.location.pathname = "ditto/" + versionValue + "/" + remainingPath;
+ }
+ }
+}
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Release notes 1.1.2</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+ <div class="summary">Version 1.1.2 of Eclipse Ditto, released on 01.07.2020</div>
+
+
+
+
+<!-- this handles the automatic toc. use ## for subheads to auto-generate the on-page minitoc. if you use html tags, you must supply an ID for the heading element in order for it to appear in the minitoc. -->
+<script>
+$( document ).ready(function() {
+ // Handler for .ready() called.
+
+$('#toc').toc({ minimumHeaders: 0, listType: 'ul', showSpeed: 0, headers: 'h2,h3,h4' });
+
+/* this offset helps account for the space taken up by the floating toolbar. */
+$('#toc').on('click', 'a', function() {
+ var target = $(this.getAttribute('href'))
+ , scroll_target = target.offset().top
+
+ $(window).scrollTop(scroll_target - 10);
+ return false
+})
+
+});
+</script>
+
+<div id="toc"></div>
+
+
+
+
+
+
+
+
+
+ <p>This is a bugfix release, no new features since <a href="release_notes_111.html">1.1.1</a> were added.</p>
+
+<h2 id="changelog">Changelog</h2>
+
+<p>Compared to the latest release <a href="release_notes_111.html">1.1.1</a>, the following changes and bugfixes were added.</p>
+
+<h3 id="changes">Changes</h3>
+
+<h4 id="publish-minor-and-micro-version-tags-to-docker-hub"><a href="https://github.com/eclipse/ditto/pull/693">Publish minor and micro version tags to Docker Hub</a></h4>
+
+<p>Starting with Ditto 1.1.2, the Docker images built and pushed to Docker Hub are:</p>
+<ul>
+ <li>full version (e.g. <code class="highlighter-rouge">1.1.2</code>)</li>
+ <li>minor version (e.g. <code class="highlighter-rouge">1.1</code>)</li>
+ <li>major version (e.g. <code class="highlighter-rouge">1</code>)</li>
+ <li><code class="highlighter-rouge">latest</code></li>
+</ul>
+
+<h3 id="bugfixes">Bugfixes</h3>
+
+<p>This is a complete list of the
+<a href="https://github.com/eclipse/ditto/pulls?q=is%3Apr+milestone%3A1.1.2">merged pull requests</a>, including the fixed bugs.</p>
+
+<h4 id="fix-nullpointerexception-when-disabling-validation-of-certificates-in-connections"><a href="https://github.com/eclipse/ditto/pull/688">Fix NullPointerException when disabling validation of certificates in connections</a></h4>
+
+<p>Fixed <a href="https://github.com/eclipse/ditto/issues/679">Mqtt 3 connection without using certificate validation</a>.</p>
+
+<h4 id="connection-creation-timeout"><a href="https://github.com/eclipse/ditto/pull/692">Connection creation timeout</a></h4>
+
+<p>There was an issue where sometimes the creation of a connection entity failed with a timeout just because the establishing of the actual connection took too much time.</p>
+
+<h4 id="minor-improvements-to-throughputperformance"><a href="https://github.com/eclipse/ditto/pull/689">Minor improvements to throughput/performance</a></h4>
+
+<p>Some minor overall simplifications and performance improvements.</p>
+
+
+ <div class="tags">
+
+ <b>Tags: </b>
+
+
+
+ <a href="tag_release_notes.html" class="btn btn-default navbar-btn cursorNorm" role="button">release_notes</a>
+
+
+
+ </div>
+
+</div>
+
+<hr class="shaded"/>
+
+<footer>
+ <div class="row">
+ <div class="col-lg-12 footer">
+ <div class="logo">
+ <a href="https://eclipse.org"><img src="images/eclipse_foundation_logo.svg" alt="Eclipse logo"/></a>
+ </div>
+ <p class="notice">
+ ©2020 Eclipse Ditto.
+ Site last generated: Jul 1, 2020 <br />
+ </p>
+ <div class="quickLinks">
+ <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
+ > Privacy Policy
+ </a>
+ <a href="https://www.eclipse.org/legal/termsofuse.php" target="_blank">
+ > Terms of Use
+ </a>
+ <a href="https://www.eclipse.org/legal/copyright.php" target="_blank">
+ > Copyright Agent
+ </a>
+ <a href="https://www.eclipse.org/legal" target="_blank">
+ > Legal
+ </a>
+ <a href="https://www.eclipse.org/legal/epl-2.0/" target="_blank">
+ > License
+ </a>
+ <a href="https://eclipse.org/security" target="_blank">
+ > Report a Vulnerability
+ </a>
+ </div>
+ </div>
+ </div>
+</footer>
+
+
+ </div>
+ <!-- /.row -->
+</div>
+<!-- /.container -->
+</div>
+<!-- /#main -->
+ </div>
+
+</body>
+</html>
diff --git a/1.1/sandbox.html b/1.1/sandbox.html
index f1d0b7d..36c2b6a 100644
--- a/1.1/sandbox.html
+++ b/1.1/sandbox.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -1540,7 +1559,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/search.json b/1.1/search.json
index 6a49b1a..b40b46c 100644
--- a/1.1/search.json
+++ b/1.1/search.json
@@ -1166,6 +1166,28 @@
{
+"title": "Release notes 1.1.1",
+"tags": "release_notes",
+"keywords": "release notes, announcements, changelog",
+"url": "release_notes_111.html",
+"summary": "Version 1.1.1 of Eclipse Ditto, released on 11.05.2020"
+}
+,
+
+
+
+{
+"title": "Release notes 1.1.2",
+"tags": "release_notes",
+"keywords": "release notes, announcements, changelog",
+"url": "release_notes_112.html",
+"summary": "Version 1.1.2 of Eclipse Ditto, released on 01.07.2020"
+}
+,
+
+
+
+{
"title": "Sandbox",
"tags": "",
"keywords": "sandbox, demo, trial",
diff --git a/1.1/tag_architecture.html b/1.1/tag_architecture.html
index 840aec7..4fbe5f2 100644
--- a/1.1/tag_architecture.html
+++ b/1.1/tag_architecture.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -2062,6 +2081,14 @@
+
+
+
+
+
+
+
+
@@ -2246,7 +2273,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/tag_blog.html b/1.1/tag_blog.html
index 955c79e..8f3b4a2 100644
--- a/1.1/tag_blog.html
+++ b/1.1/tag_blog.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -2020,6 +2039,14 @@
+
+
+
+
+
+
+
+
@@ -2372,7 +2399,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/tag_client_sdk.html b/1.1/tag_client_sdk.html
index 53eae8d..4bb7956 100644
--- a/1.1/tag_client_sdk.html
+++ b/1.1/tag_client_sdk.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -2048,6 +2067,14 @@
+
+
+
+
+
+
+
+
@@ -2232,7 +2259,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/tag_connectivity.html b/1.1/tag_connectivity.html
index 27350fb..e3309ae 100644
--- a/1.1/tag_connectivity.html
+++ b/1.1/tag_connectivity.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -2110,6 +2129,14 @@
+
+
+
+
+
+
+
+
@@ -2318,7 +2345,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/tag_getting_started.html b/1.1/tag_getting_started.html
index 868e9da..2f11f2a 100644
--- a/1.1/tag_getting_started.html
+++ b/1.1/tag_getting_started.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -2062,6 +2081,14 @@
+
+
+
+
+
+
+
+
@@ -2246,7 +2273,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/tag_http.html b/1.1/tag_http.html
index 8521b7b..a5f1766 100644
--- a/1.1/tag_http.html
+++ b/1.1/tag_http.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -2056,6 +2075,14 @@
+
+
+
+
+
+
+
+
@@ -2240,7 +2267,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/tag_installation.html b/1.1/tag_installation.html
index 5e54082..77994d4 100644
--- a/1.1/tag_installation.html
+++ b/1.1/tag_installation.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -2038,6 +2057,14 @@
+
+
+
+
+
+
+
+
@@ -2222,7 +2249,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/tag_model.html b/1.1/tag_model.html
index 8c2b10e..2de6ddb 100644
--- a/1.1/tag_model.html
+++ b/1.1/tag_model.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -2086,6 +2105,14 @@
+
+
+
+
+
+
+
+
@@ -2270,7 +2297,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/tag_news.html b/1.1/tag_news.html
index 7ffab1c..4364f74 100644
--- a/1.1/tag_news.html
+++ b/1.1/tag_news.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -2020,6 +2039,14 @@
+
+
+
+
+
+
+
+
@@ -2204,7 +2231,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/tag_protocol.html b/1.1/tag_protocol.html
index 4030574..4fa8eb1 100644
--- a/1.1/tag_protocol.html
+++ b/1.1/tag_protocol.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -2176,6 +2195,14 @@
+
+
+
+
+
+
+
+
@@ -2360,7 +2387,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/tag_release_notes.html b/1.1/tag_release_notes.html
index d9a4467..1fa906c 100644
--- a/1.1/tag_release_notes.html
+++ b/1.1/tag_release_notes.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -2116,6 +2135,26 @@
+
+
+ <tr><td><a href="release_notes_111.html">Release notes 1.1.1</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Version 1.1.1 of Eclipse Ditto, released on 11.05.2020 </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="release_notes_112.html">Release notes 1.1.2</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Version 1.1.2 of Eclipse Ditto, released on 01.07.2020 </td>
+ </tr>
+
+
+
+
@@ -2300,7 +2339,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/tag_rql.html b/1.1/tag_rql.html
index 98c215e..7d46e66 100644
--- a/1.1/tag_rql.html
+++ b/1.1/tag_rql.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -2080,6 +2099,14 @@
+
+
+
+
+
+
+
+
@@ -2270,7 +2297,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/tag_search.html b/1.1/tag_search.html
index 0fcf1cf..d5f8b73 100644
--- a/1.1/tag_search.html
+++ b/1.1/tag_search.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -2056,6 +2075,14 @@
+
+
+
+
+
+
+
+
@@ -2240,7 +2267,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/tag_signal.html b/1.1/tag_signal.html
index 760ee7f..7670a1c 100644
--- a/1.1/tag_signal.html
+++ b/1.1/tag_signal.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -2055,6 +2074,14 @@
+
+
+
+
+
+
+
+
@@ -2239,7 +2266,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/tag_troubleshooting.html b/1.1/tag_troubleshooting.html
index 13f9a7c..69f1292 100644
--- a/1.1/tag_troubleshooting.html
+++ b/1.1/tag_troubleshooting.html
@@ -252,6 +252,20 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
<li><a href="release_notes_110.html">1.1.0</a></li>
@@ -715,6 +729,11 @@
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
<li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
@@ -2026,6 +2045,14 @@
+
+
+
+
+
+
+
+
@@ -2210,7 +2237,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2017-11-10-welcome-to-ditto.html b/2017-11-10-welcome-to-ditto.html
index ff1ca3d..efef57a 100644
--- a/2017-11-10-welcome-to-ditto.html
+++ b/2017-11-10-welcome-to-ditto.html
@@ -264,7 +264,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2017-12-18-milestone-announcement-010-M1.html b/2017-12-18-milestone-announcement-010-M1.html
index 943da44..9f34025 100644
--- a/2017-12-18-milestone-announcement-010-M1.html
+++ b/2017-12-18-milestone-announcement-010-M1.html
@@ -268,7 +268,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2018-01-12-milestone-announcement-010-M3.html b/2018-01-12-milestone-announcement-010-M3.html
index 9e78b79..a0bb673 100644
--- a/2018-01-12-milestone-announcement-010-M3.html
+++ b/2018-01-12-milestone-announcement-010-M3.html
@@ -287,7 +287,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2018-01-15-example-demonstrating-rest-to-websocket.html b/2018-01-15-example-demonstrating-rest-to-websocket.html
index d9d565a..18dfb97 100644
--- a/2018-01-15-example-demonstrating-rest-to-websocket.html
+++ b/2018-01-15-example-demonstrating-rest-to-websocket.html
@@ -276,7 +276,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2018-02-07-milestone-announcement-020-M1.html b/2018-02-07-milestone-announcement-020-M1.html
index cae16a5..1a484d5 100644
--- a/2018-02-07-milestone-announcement-020-M1.html
+++ b/2018-02-07-milestone-announcement-020-M1.html
@@ -288,7 +288,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2018-02-08-feature-definition.html b/2018-02-08-feature-definition.html
index 75c9a85..fb8c0db 100644
--- a/2018-02-08-feature-definition.html
+++ b/2018-02-08-feature-definition.html
@@ -318,7 +318,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2018-04-25-connectivity-service.html b/2018-04-25-connectivity-service.html
index 0838fc4..a65e841 100644
--- a/2018-04-25-connectivity-service.html
+++ b/2018-04-25-connectivity-service.html
@@ -332,7 +332,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2018-04-26-milestone-announcement-030-M1.html b/2018-04-26-milestone-announcement-030-M1.html
index 4160311..b2bb7cc 100644
--- a/2018-04-26-milestone-announcement-030-M1.html
+++ b/2018-04-26-milestone-announcement-030-M1.html
@@ -284,7 +284,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2018-05-02-connecting-ditto-hono.html b/2018-05-02-connecting-ditto-hono.html
index 04ec8ad..7f01943 100644
--- a/2018-05-02-connecting-ditto-hono.html
+++ b/2018-05-02-connecting-ditto-hono.html
@@ -1006,7 +1006,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2018-06-15-milestone-announcement-030-M2.html b/2018-06-15-milestone-announcement-030-M2.html
index 5833615..0c1f143 100644
--- a/2018-06-15-milestone-announcement-030-M2.html
+++ b/2018-06-15-milestone-announcement-030-M2.html
@@ -284,7 +284,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2018-08-14-milestone-announcement-080-M1.html b/2018-08-14-milestone-announcement-080-M1.html
index 31ff483..d8a69bd 100644
--- a/2018-08-14-milestone-announcement-080-M1.html
+++ b/2018-08-14-milestone-announcement-080-M1.html
@@ -284,7 +284,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2018-09-21-selective-push-notifications.html b/2018-09-21-selective-push-notifications.html
index 6fdab3a..39536ca 100644
--- a/2018-09-21-selective-push-notifications.html
+++ b/2018-09-21-selective-push-notifications.html
@@ -484,7 +484,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2018-09-27-milestone-announcement-080-M2.html b/2018-09-27-milestone-announcement-080-M2.html
index 3c4d887..e690c4b 100644
--- a/2018-09-27-milestone-announcement-080-M2.html
+++ b/2018-09-27-milestone-announcement-080-M2.html
@@ -286,7 +286,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2018-10-16-example-mqtt-bidirectional.html b/2018-10-16-example-mqtt-bidirectional.html
index 5cf6186..694c483 100644
--- a/2018-10-16-example-mqtt-bidirectional.html
+++ b/2018-10-16-example-mqtt-bidirectional.html
@@ -292,7 +292,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2018-11-14-milestone-announcement-080-M3.html b/2018-11-14-milestone-announcement-080-M3.html
index ac87a54..eb285ac 100644
--- a/2018-11-14-milestone-announcement-080-M3.html
+++ b/2018-11-14-milestone-announcement-080-M3.html
@@ -285,7 +285,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2018-11-28-release-announcement-080.html b/2018-11-28-release-announcement-080.html
index 00c2942..fc5666a 100644
--- a/2018-11-28-release-announcement-080.html
+++ b/2018-11-28-release-announcement-080.html
@@ -280,7 +280,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2018-12-05-example-command-and-control.html b/2018-12-05-example-command-and-control.html
index 6f71400..0b78c63 100644
--- a/2018-12-05-example-command-and-control.html
+++ b/2018-12-05-example-command-and-control.html
@@ -519,7 +519,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2019-03-13-kafka-connectivity.html b/2019-03-13-kafka-connectivity.html
index b4aafa6..b9c4a5b 100644
--- a/2019-03-13-kafka-connectivity.html
+++ b/2019-03-13-kafka-connectivity.html
@@ -266,7 +266,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2019-03-28-milestone-announcement-090-M1.html b/2019-03-28-milestone-announcement-090-M1.html
index 23f3282..2e63693 100644
--- a/2019-03-28-milestone-announcement-090-M1.html
+++ b/2019-03-28-milestone-announcement-090-M1.html
@@ -282,7 +282,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2019-04-29-milestone-announcement-090-M2.html b/2019-04-29-milestone-announcement-090-M2.html
index ea16b40..63c1251 100644
--- a/2019-04-29-milestone-announcement-090-M2.html
+++ b/2019-04-29-milestone-announcement-090-M2.html
@@ -280,7 +280,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2019-07-10-release-announcement-090.html b/2019-07-10-release-announcement-090.html
index c7d6419..bc931fd 100644
--- a/2019-07-10-release-announcement-090.html
+++ b/2019-07-10-release-announcement-090.html
@@ -286,7 +286,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2019-08-28-openid-connect.html b/2019-08-28-openid-connect.html
index 12f77f3..940c1ab 100644
--- a/2019-08-28-openid-connect.html
+++ b/2019-08-28-openid-connect.html
@@ -332,7 +332,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2019-09-17-milestone-announcement-100-M1a.html b/2019-09-17-milestone-announcement-100-M1a.html
index a32e9a9..144f3fa 100644
--- a/2019-09-17-milestone-announcement-100-M1a.html
+++ b/2019-09-17-milestone-announcement-100-M1a.html
@@ -283,7 +283,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2019-10-17-http-connectivity.html b/2019-10-17-http-connectivity.html
index ccecc99..c39e1c9 100644
--- a/2019-10-17-http-connectivity.html
+++ b/2019-10-17-http-connectivity.html
@@ -291,7 +291,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2019-11-04-milestone-announcement-100-M2.html b/2019-11-04-milestone-announcement-100-M2.html
index 44ba91f..ea00975 100644
--- a/2019-11-04-milestone-announcement-100-M2.html
+++ b/2019-11-04-milestone-announcement-100-M2.html
@@ -282,7 +282,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2019-12-12-release-announcement-100.html b/2019-12-12-release-announcement-100.html
index 359cee2..7ff13a3 100644
--- a/2019-12-12-release-announcement-100.html
+++ b/2019-12-12-release-announcement-100.html
@@ -331,7 +331,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2020-04-16-connecting-to-ttn-via-mqtt.html b/2020-04-16-connecting-to-ttn-via-mqtt.html
index 5abff99..d141522 100644
--- a/2020-04-16-connecting-to-ttn-via-mqtt.html
+++ b/2020-04-16-connecting-to-ttn-via-mqtt.html
@@ -778,7 +778,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2020-04-29-release-announcement-110.html b/2020-04-29-release-announcement-110.html
index da9940c..9529814 100644
--- a/2020-04-29-release-announcement-110.html
+++ b/2020-04-29-release-announcement-110.html
@@ -312,7 +312,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/404.html b/404.html
index e70d895..c398544 100644
--- a/404.html
+++ b/404.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1497,7 +1504,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/architecture-overview.html b/architecture-overview.html
index 2159d26..b56b22e 100644
--- a/architecture-overview.html
+++ b/architecture-overview.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1550,7 +1557,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/architecture-services-concierge.html b/architecture-services-concierge.html
index 6f4574e..e83bba5 100644
--- a/architecture-services-concierge.html
+++ b/architecture-services-concierge.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1536,7 +1543,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/architecture-services-connectivity.html b/architecture-services-connectivity.html
index aae87ac..6b79896 100644
--- a/architecture-services-connectivity.html
+++ b/architecture-services-connectivity.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1550,7 +1557,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/architecture-services-gateway.html b/architecture-services-gateway.html
index c6185e4..010f88d 100644
--- a/architecture-services-gateway.html
+++ b/architecture-services-gateway.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1528,7 +1535,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/architecture-services-policies.html b/architecture-services-policies.html
index 7955d63..d956473 100644
--- a/architecture-services-policies.html
+++ b/architecture-services-policies.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1529,7 +1536,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/architecture-services-things-search.html b/architecture-services-things-search.html
index 857d584..eccd5c1 100644
--- a/architecture-services-things-search.html
+++ b/architecture-services-things-search.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1573,7 +1580,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/architecture-services-things.html b/architecture-services-things.html
index 8cc2dc2..2905b40 100644
--- a/architecture-services-things.html
+++ b/architecture-services-things.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1529,7 +1536,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/basic-acknowledgements.html b/basic-acknowledgements.html
index 38d142d..a00e1a7 100644
--- a/basic-acknowledgements.html
+++ b/basic-acknowledgements.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1678,7 +1685,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/basic-acl.html b/basic-acl.html
index 89a692a..a6cc73a 100644
--- a/basic-acl.html
+++ b/basic-acl.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1567,7 +1574,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/basic-apis.html b/basic-apis.html
index 05a6662..c9c175b 100644
--- a/basic-apis.html
+++ b/basic-apis.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1625,7 +1632,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/basic-auth.html b/basic-auth.html
index 31231b1..24a6bfb 100644
--- a/basic-auth.html
+++ b/basic-auth.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1546,7 +1553,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/basic-changenotifications.html b/basic-changenotifications.html
index f0ec806..b1db2fd 100644
--- a/basic-changenotifications.html
+++ b/basic-changenotifications.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1569,7 +1576,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/basic-connections.html b/basic-connections.html
index 0b95bc1..6a2e80f 100644
--- a/basic-connections.html
+++ b/basic-connections.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1964,7 +1971,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/basic-enrichment.html b/basic-enrichment.html
index 9a70b8f..f102506 100644
--- a/basic-enrichment.html
+++ b/basic-enrichment.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1602,7 +1609,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/basic-feature.html b/basic-feature.html
index 1063dce..78e17fc 100644
--- a/basic-feature.html
+++ b/basic-feature.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1730,7 +1737,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/basic-messages.html b/basic-messages.html
index cb55a6b..2dd57d9 100644
--- a/basic-messages.html
+++ b/basic-messages.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1639,7 +1646,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/basic-namespaces-and-names.html b/basic-namespaces-and-names.html
index 325898b..ab20717 100644
--- a/basic-namespaces-and-names.html
+++ b/basic-namespaces-and-names.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1569,7 +1576,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/basic-overview.html b/basic-overview.html
index 58b2539..9266811 100644
--- a/basic-overview.html
+++ b/basic-overview.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1642,7 +1649,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/basic-placeholders.html b/basic-placeholders.html
index 29b9dc2..12d45b8 100644
--- a/basic-placeholders.html
+++ b/basic-placeholders.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1768,7 +1775,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/basic-policy.html b/basic-policy.html
index 870babd..f2e0633 100644
--- a/basic-policy.html
+++ b/basic-policy.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1908,7 +1915,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/basic-rql.html b/basic-rql.html
index da38612..9a8bbb9 100644
--- a/basic-rql.html
+++ b/basic-rql.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1748,7 +1755,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/basic-search.html b/basic-search.html
index d6d2700..a4166fd 100644
--- a/basic-search.html
+++ b/basic-search.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1641,7 +1648,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/basic-signals-command.html b/basic-signals-command.html
index 0338537..583300f 100644
--- a/basic-signals-command.html
+++ b/basic-signals-command.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1527,7 +1534,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/basic-signals-commandresponse.html b/basic-signals-commandresponse.html
index 2ef51e7..82a8e5f 100644
--- a/basic-signals-commandresponse.html
+++ b/basic-signals-commandresponse.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1507,7 +1514,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/basic-signals-errorresponse.html b/basic-signals-errorresponse.html
index 07d4971..bcc85a1 100644
--- a/basic-signals-errorresponse.html
+++ b/basic-signals-errorresponse.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1509,7 +1516,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/basic-signals-event.html b/basic-signals-event.html
index e76c027..692ac4c 100644
--- a/basic-signals-event.html
+++ b/basic-signals-event.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1513,7 +1520,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/basic-signals.html b/basic-signals.html
index 86bed32..7bc6755 100644
--- a/basic-signals.html
+++ b/basic-signals.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1557,7 +1564,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/basic-thing.html b/basic-thing.html
index 1b1ab92..75504ca 100644
--- a/basic-thing.html
+++ b/basic-thing.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1593,7 +1600,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/blog.html b/blog.html
index 146e789..65ba896 100644
--- a/blog.html
+++ b/blog.html
@@ -393,7 +393,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/blog_archive.html b/blog_archive.html
index f22e70f..5bece99 100644
--- a/blog_archive.html
+++ b/blog_archive.html
@@ -446,7 +446,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/client-sdk-java.html b/client-sdk-java.html
index 84d4d58..2a1ee4d 100644
--- a/client-sdk-java.html
+++ b/client-sdk-java.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1754,7 +1761,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/client-sdk-javascript.html b/client-sdk-javascript.html
index 0a1305f..5195a6e 100644
--- a/client-sdk-javascript.html
+++ b/client-sdk-javascript.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1563,7 +1570,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/client-sdk-overview.html b/client-sdk-overview.html
index c66c344..92bbca6 100644
--- a/client-sdk-overview.html
+++ b/client-sdk-overview.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1510,7 +1517,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/connectivity-header-mapping.html b/connectivity-header-mapping.html
index d644b12..bc61a53 100644
--- a/connectivity-header-mapping.html
+++ b/connectivity-header-mapping.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1520,7 +1527,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/connectivity-manage-connections.html b/connectivity-manage-connections.html
index 0bdf3d1..c2e14e9 100644
--- a/connectivity-manage-connections.html
+++ b/connectivity-manage-connections.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1825,7 +1832,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/connectivity-mapping.html b/connectivity-mapping.html
index cbe27e0..e096012 100644
--- a/connectivity-mapping.html
+++ b/connectivity-mapping.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -2290,7 +2297,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/connectivity-overview.html b/connectivity-overview.html
index 51bcb6b..11abc6c 100644
--- a/connectivity-overview.html
+++ b/connectivity-overview.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1521,7 +1528,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/connectivity-protocol-bindings-amqp091.html b/connectivity-protocol-bindings-amqp091.html
index 3578c66..cdfea99 100644
--- a/connectivity-protocol-bindings-amqp091.html
+++ b/connectivity-protocol-bindings-amqp091.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1619,7 +1626,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/connectivity-protocol-bindings-amqp10.html b/connectivity-protocol-bindings-amqp10.html
index 3f2332d..00cabbd 100644
--- a/connectivity-protocol-bindings-amqp10.html
+++ b/connectivity-protocol-bindings-amqp10.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1665,7 +1672,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/connectivity-protocol-bindings-http.html b/connectivity-protocol-bindings-http.html
index eaaaef6..8fd75d1 100644
--- a/connectivity-protocol-bindings-http.html
+++ b/connectivity-protocol-bindings-http.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1577,6 +1584,49 @@
</span><span class="p">}</span><span class="w">
</span></code></pre></div></div>
+<h2 id="client-certificate-authentication">Client-certificate authentication</h2>
+
+<p>Ditto supports certificate-based authentication for HTTP connections. Consult
+<a href="connectivity-tls-certificates.html">Certificates for Transport Layer Security</a>
+for how to set it up.</p>
+
+<p>Here is an example HTTP connection that checks the server certificate and authenticates by a client certificate.</p>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"connection"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http-example-connection-123"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"connectionType"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http-push"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"connectionStatus"</span><span class="p">:</span><span class="w"> </span><span class="s2">"open"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"failoverEnabled"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"uri"</span><span class="p">:</span><span class="w"> </span><span class="s2">"https://localhost:80"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"validateCertificates"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"ca"</span><span class="p">:</span><span class="w"> </span><span class="s2">"-----BEGIN CERTIFICATE-----</span><span class="se">\n</span><span class="s2"><localhost certificate></span><span class="se">\n</span><span class="s2">-----END CERTIFICATE-----"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"credentials"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"client-cert"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"cert"</span><span class="p">:</span><span class="w"> </span><span class="s2">"-----BEGIN CERTIFICATE-----</span><span class="se">\n</span><span class="s2"><signed client certificate></span><span class="se">\n</span><span class="s2">-----END CERTIFICATE-----"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"key"</span><span class="p">:</span><span class="w"> </span><span class="s2">"-----BEGIN PRIVATE KEY-----</span><span class="se">\n</span><span class="s2"><client private key></span><span class="se">\n</span><span class="s2">-----END PRIVATE KEY-----"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"specificConfig"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"parallelism"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"sources"</span><span class="p">:</span><span class="w"> </span><span class="p">[],</span><span class="w">
+ </span><span class="s2">"targets"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
+ </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"address"</span><span class="p">:</span><span class="w"> </span><span class="s2">"PUT:/api/2/some-entity/{{ thing:id }}"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"topics"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
+ </span><span class="s2">"_/_/things/twin/events"</span><span class="w">
+ </span><span class="p">],</span><span class="w">
+ </span><span class="s2">"authorizationContext"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">"ditto:outbound-auth-subject"</span><span class="p">,</span><span class="w"> </span><span class="s2">"..."</span><span class="p">],</span><span class="w">
+ </span><span class="s2">"headerMapping"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"{{ header:content-type }}"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"api-key"</span><span class="p">:</span><span class="w"> </span><span class="s2">"this-is-a-secret-api-key-to-send-along"</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">]</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
<div class="tags">
@@ -1610,7 +1660,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/connectivity-protocol-bindings-kafka2.html b/connectivity-protocol-bindings-kafka2.html
index 0ecd36c..8a1e875 100644
--- a/connectivity-protocol-bindings-kafka2.html
+++ b/connectivity-protocol-bindings-kafka2.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1609,7 +1616,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/connectivity-protocol-bindings-mqtt.html b/connectivity-protocol-bindings-mqtt.html
index 782627a..00b0585 100644
--- a/connectivity-protocol-bindings-mqtt.html
+++ b/connectivity-protocol-bindings-mqtt.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1714,7 +1721,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/connectivity-protocol-bindings-mqtt5.html b/connectivity-protocol-bindings-mqtt5.html
index 1cf3d54..ef2a406 100644
--- a/connectivity-protocol-bindings-mqtt5.html
+++ b/connectivity-protocol-bindings-mqtt5.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1682,7 +1689,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/connectivity-tls-certificates.html b/connectivity-tls-certificates.html
index ef46962..7753bb7 100644
--- a/connectivity-tls-certificates.html
+++ b/connectivity-tls-certificates.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1551,7 +1558,8 @@
<h2 id="authenticate-by-client-certificate">Authenticate by client certificate</h2>
-<p><em>Client-certificate authentication is available for <a href="connectivity-protocol-bindings-mqtt.html">MQTT connections</a> only.</em></p>
+<p><em>Client-certificate authentication is available for <a href="connectivity-protocol-bindings-mqtt.html">MQTT connections</a>
+ and <a href="connectivity-protocol-bindings-http.html">HTTP connections</a> only.</em></p>
<h3 id="connection-configuration-1">Connection configuration</h3>
@@ -1616,7 +1624,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/feed.xml b/feed.xml
index 339e63a..1b14458 100644
--- a/feed.xml
+++ b/feed.xml
@@ -5,8 +5,8 @@
<description>Announcements, tutorials and examples around Eclipse Ditto and Digital Twins</description>
<link>https://www.eclipse.org/ditto/</link>
<atom:link href="https://www.eclipse.org/ditto/feed.xml" rel="self" type="application/rss+xml"/>
- <pubDate>Tue, 09 Jun 2020 11:48:02 +0000</pubDate>
- <lastBuildDate>Tue, 09 Jun 2020 11:48:02 +0000</lastBuildDate>
+ <pubDate>Wed, 01 Jul 2020 13:43:12 +0000</pubDate>
+ <lastBuildDate>Wed, 01 Jul 2020 13:43:12 +0000</lastBuildDate>
<generator>Jekyll v3.6.2</generator>
<item>
diff --git a/feedback.html b/feedback.html
index 800d38a..c134593 100644
--- a/feedback.html
+++ b/feedback.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1522,7 +1529,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/glossary.html b/glossary.html
index 2fa37f5..ab18a2f 100644
--- a/glossary.html
+++ b/glossary.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1510,7 +1517,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/http-api-doc.html b/http-api-doc.html
index 438dbc7..74e8345 100644
--- a/http-api-doc.html
+++ b/http-api-doc.html
@@ -201,7 +201,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/httpapi-concepts.html b/httpapi-concepts.html
index 4dded49..3749c07 100644
--- a/httpapi-concepts.html
+++ b/httpapi-concepts.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -2096,7 +2103,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/httpapi-messages.html b/httpapi-messages.html
index 6a97d06..7318d36 100644
--- a/httpapi-messages.html
+++ b/httpapi-messages.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1598,7 +1605,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/httpapi-overview.html b/httpapi-overview.html
index 18307bc..155d47f 100644
--- a/httpapi-overview.html
+++ b/httpapi-overview.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1518,7 +1525,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/httpapi-protocol-bindings-websocket.html b/httpapi-protocol-bindings-websocket.html
index dfb542c..624c715 100644
--- a/httpapi-protocol-bindings-websocket.html
+++ b/httpapi-protocol-bindings-websocket.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1798,7 +1805,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/httpapi-search.html b/httpapi-search.html
index e3c67ba..5c7434d 100644
--- a/httpapi-search.html
+++ b/httpapi-search.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1565,7 +1572,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/httpapi-sse.html b/httpapi-sse.html
index 32ec317..c5a25c8 100644
--- a/httpapi-sse.html
+++ b/httpapi-sse.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1744,7 +1751,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/index.html b/index.html
index 6579219..05f1f66 100644
--- a/index.html
+++ b/index.html
@@ -264,7 +264,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/installation-building.html b/installation-building.html
index 049960f..4811c13 100644
--- a/installation-building.html
+++ b/installation-building.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1537,7 +1544,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/installation-operating.html b/installation-operating.html
index 5b4ca24..9cb40f5 100644
--- a/installation-operating.html
+++ b/installation-operating.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -2393,7 +2400,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/installation-running.html b/installation-running.html
index 2761e6d..044718a 100644
--- a/installation-running.html
+++ b/installation-running.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1565,7 +1572,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/intro-digitaltwins.html b/intro-digitaltwins.html
index 52ccb80..cc2197a 100644
--- a/intro-digitaltwins.html
+++ b/intro-digitaltwins.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1540,7 +1547,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/intro-hello-world.html b/intro-hello-world.html
index 258673d..81375a9 100644
--- a/intro-hello-world.html
+++ b/intro-hello-world.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1629,7 +1636,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/intro-overview.html b/intro-overview.html
index 3ee5cd6..6981d1f 100644
--- a/intro-overview.html
+++ b/intro-overview.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1556,7 +1563,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/presentations.html b/presentations.html
index 65035c1..3aad165 100644
--- a/presentations.html
+++ b/presentations.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1538,7 +1545,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-bindings.html b/protocol-bindings.html
index 47b61a6..695514c 100644
--- a/protocol-bindings.html
+++ b/protocol-bindings.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1529,7 +1536,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-createattribute.html b/protocol-examples-createattribute.html
index daa19de..c91721b 100644
--- a/protocol-examples-createattribute.html
+++ b/protocol-examples-createattribute.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1532,7 +1539,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-createattributes.html b/protocol-examples-createattributes.html
index 24cdbc8..be289ce 100644
--- a/protocol-examples-createattributes.html
+++ b/protocol-examples-createattributes.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1537,7 +1544,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-createdefinition.html b/protocol-examples-createdefinition.html
index a876918..62333ad 100644
--- a/protocol-examples-createdefinition.html
+++ b/protocol-examples-createdefinition.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1530,7 +1537,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-createfeature.html b/protocol-examples-createfeature.html
index 230fb68..22e96e3 100644
--- a/protocol-examples-createfeature.html
+++ b/protocol-examples-createfeature.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1541,7 +1548,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-createfeatures.html b/protocol-examples-createfeatures.html
index 3cf85a3..337df30 100644
--- a/protocol-examples-createfeatures.html
+++ b/protocol-examples-createfeatures.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1545,7 +1552,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-createproperties.html b/protocol-examples-createproperties.html
index f0b41ca..864ac94 100644
--- a/protocol-examples-createproperties.html
+++ b/protocol-examples-createproperties.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1536,7 +1543,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-createproperty.html b/protocol-examples-createproperty.html
index f3809b8..2e29b01 100644
--- a/protocol-examples-createproperty.html
+++ b/protocol-examples-createproperty.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1526,7 +1533,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-creatething.html b/protocol-examples-creatething.html
index b18e92e..5457863 100644
--- a/protocol-examples-creatething.html
+++ b/protocol-examples-creatething.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1625,7 +1632,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-createthingdefinition.html b/protocol-examples-createthingdefinition.html
index f9239d3..bd36ecc 100644
--- a/protocol-examples-createthingdefinition.html
+++ b/protocol-examples-createthingdefinition.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1527,7 +1534,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-deleteattribute.html b/protocol-examples-deleteattribute.html
index 11eff21..b72755d 100644
--- a/protocol-examples-deleteattribute.html
+++ b/protocol-examples-deleteattribute.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1524,7 +1531,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-deleteattributes.html b/protocol-examples-deleteattributes.html
index 5b47bc3..138b994 100644
--- a/protocol-examples-deleteattributes.html
+++ b/protocol-examples-deleteattributes.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1524,7 +1531,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-deletedefinition.html b/protocol-examples-deletedefinition.html
index b6dc3d0..104912a 100644
--- a/protocol-examples-deletedefinition.html
+++ b/protocol-examples-deletedefinition.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1524,7 +1531,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-deletefeature.html b/protocol-examples-deletefeature.html
index 9fe3ca6..8af731d 100644
--- a/protocol-examples-deletefeature.html
+++ b/protocol-examples-deletefeature.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1524,7 +1531,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-deletefeatures.html b/protocol-examples-deletefeatures.html
index 8844e84..624b8de 100644
--- a/protocol-examples-deletefeatures.html
+++ b/protocol-examples-deletefeatures.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1524,7 +1531,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-deleteproperties.html b/protocol-examples-deleteproperties.html
index e2cd9b5..06830fd 100644
--- a/protocol-examples-deleteproperties.html
+++ b/protocol-examples-deleteproperties.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1524,7 +1531,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-deleteproperty.html b/protocol-examples-deleteproperty.html
index 4fa9121..190cb9e 100644
--- a/protocol-examples-deleteproperty.html
+++ b/protocol-examples-deleteproperty.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1524,7 +1531,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-deletething.html b/protocol-examples-deletething.html
index 120bae4..ea9d1c5 100644
--- a/protocol-examples-deletething.html
+++ b/protocol-examples-deletething.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1524,7 +1531,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-deletethingdefinition.html b/protocol-examples-deletethingdefinition.html
index 3db62de..05c5407 100644
--- a/protocol-examples-deletethingdefinition.html
+++ b/protocol-examples-deletethingdefinition.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1524,7 +1531,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-errorresponses.html b/protocol-examples-errorresponses.html
index 0766031..4337d6d 100644
--- a/protocol-examples-errorresponses.html
+++ b/protocol-examples-errorresponses.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1959,7 +1966,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-modifyattribute.html b/protocol-examples-modifyattribute.html
index aff241d..6406d26 100644
--- a/protocol-examples-modifyattribute.html
+++ b/protocol-examples-modifyattribute.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1532,7 +1539,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-modifyattributes.html b/protocol-examples-modifyattributes.html
index f5512f1..e623868 100644
--- a/protocol-examples-modifyattributes.html
+++ b/protocol-examples-modifyattributes.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1537,7 +1544,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-modifydefinition.html b/protocol-examples-modifydefinition.html
index 0777c96..5a42361 100644
--- a/protocol-examples-modifydefinition.html
+++ b/protocol-examples-modifydefinition.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1530,7 +1537,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-modifyfeature.html b/protocol-examples-modifyfeature.html
index e627f90..beeebe3 100644
--- a/protocol-examples-modifyfeature.html
+++ b/protocol-examples-modifyfeature.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1541,7 +1548,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-modifyfeatures.html b/protocol-examples-modifyfeatures.html
index 182fd23..5b17826 100644
--- a/protocol-examples-modifyfeatures.html
+++ b/protocol-examples-modifyfeatures.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1545,7 +1552,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-modifypolicyid.html b/protocol-examples-modifypolicyid.html
index f69a3fc..33a8e54 100644
--- a/protocol-examples-modifypolicyid.html
+++ b/protocol-examples-modifypolicyid.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1548,7 +1555,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-modifyproperties.html b/protocol-examples-modifyproperties.html
index ba99207..07a6fd2 100644
--- a/protocol-examples-modifyproperties.html
+++ b/protocol-examples-modifyproperties.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1536,7 +1543,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-modifyproperty.html b/protocol-examples-modifyproperty.html
index b48ecf9..5811297 100644
--- a/protocol-examples-modifyproperty.html
+++ b/protocol-examples-modifyproperty.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1526,7 +1533,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-modifything.html b/protocol-examples-modifything.html
index 62a7f55..1a53cdf 100644
--- a/protocol-examples-modifything.html
+++ b/protocol-examples-modifything.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1606,7 +1613,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-modifythingdefinition.html b/protocol-examples-modifythingdefinition.html
index 34dbdbe..3438039 100644
--- a/protocol-examples-modifythingdefinition.html
+++ b/protocol-examples-modifythingdefinition.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1526,7 +1533,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-policies-createpolicy.html b/protocol-examples-policies-createpolicy.html
index d9139c9..f33ea42 100644
--- a/protocol-examples-policies-createpolicy.html
+++ b/protocol-examples-policies-createpolicy.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1560,7 +1567,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-policies-createpolicyentry.html b/protocol-examples-policies-createpolicyentry.html
index 62c6314..d0c4143 100644
--- a/protocol-examples-policies-createpolicyentry.html
+++ b/protocol-examples-policies-createpolicyentry.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1536,7 +1543,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-policies-createresource.html b/protocol-examples-policies-createresource.html
index 55ae2f7..d2ec1fd 100644
--- a/protocol-examples-policies-createresource.html
+++ b/protocol-examples-policies-createresource.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1525,7 +1532,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-policies-createsubject.html b/protocol-examples-policies-createsubject.html
index 517f289..6fd1550 100644
--- a/protocol-examples-policies-createsubject.html
+++ b/protocol-examples-policies-createsubject.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1521,7 +1528,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-policies-deletepolicy.html b/protocol-examples-policies-deletepolicy.html
index 6762586..9c0e69e 100644
--- a/protocol-examples-policies-deletepolicy.html
+++ b/protocol-examples-policies-deletepolicy.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1518,7 +1525,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-policies-deletepolicyentry.html b/protocol-examples-policies-deletepolicyentry.html
index efb92a2..a32d227 100644
--- a/protocol-examples-policies-deletepolicyentry.html
+++ b/protocol-examples-policies-deletepolicyentry.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1518,7 +1525,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-policies-deleteresource.html b/protocol-examples-policies-deleteresource.html
index fc760c7..42b95c0 100644
--- a/protocol-examples-policies-deleteresource.html
+++ b/protocol-examples-policies-deleteresource.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1518,7 +1525,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-policies-deletesubject.html b/protocol-examples-policies-deletesubject.html
index f3063a7..b0ca1b2 100644
--- a/protocol-examples-policies-deletesubject.html
+++ b/protocol-examples-policies-deletesubject.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1518,7 +1525,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-policies-errorresponses.html b/protocol-examples-policies-errorresponses.html
index 99eb51e..daa5334 100644
--- a/protocol-examples-policies-errorresponses.html
+++ b/protocol-examples-policies-errorresponses.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1856,7 +1863,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-policies-modifypolicy.html b/protocol-examples-policies-modifypolicy.html
index 7d2b782..2ee40d4 100644
--- a/protocol-examples-policies-modifypolicy.html
+++ b/protocol-examples-policies-modifypolicy.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1539,7 +1546,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-policies-modifypolicyentries.html b/protocol-examples-policies-modifypolicyentries.html
index 00b7f29..08c776d 100644
--- a/protocol-examples-policies-modifypolicyentries.html
+++ b/protocol-examples-policies-modifypolicyentries.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1558,7 +1565,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-policies-modifypolicyentry.html b/protocol-examples-policies-modifypolicyentry.html
index 4338787..f65d981 100644
--- a/protocol-examples-policies-modifypolicyentry.html
+++ b/protocol-examples-policies-modifypolicyentry.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1536,7 +1543,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-policies-modifyresource.html b/protocol-examples-policies-modifyresource.html
index 74ff05c..cbb43a3 100644
--- a/protocol-examples-policies-modifyresource.html
+++ b/protocol-examples-policies-modifyresource.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1525,7 +1532,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-policies-modifyresources.html b/protocol-examples-policies-modifyresources.html
index 9e826d0..8e6bf3f 100644
--- a/protocol-examples-policies-modifyresources.html
+++ b/protocol-examples-policies-modifyresources.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1528,7 +1535,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-policies-modifysubject.html b/protocol-examples-policies-modifysubject.html
index 49b8774..4cb8f26 100644
--- a/protocol-examples-policies-modifysubject.html
+++ b/protocol-examples-policies-modifysubject.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1521,7 +1528,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-policies-modifysubjects.html b/protocol-examples-policies-modifysubjects.html
index 3d10513..abe6807 100644
--- a/protocol-examples-policies-modifysubjects.html
+++ b/protocol-examples-policies-modifysubjects.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1524,7 +1531,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-policies-retrievepolicy.html b/protocol-examples-policies-retrievepolicy.html
index f1e3fa7..7ef8237 100644
--- a/protocol-examples-policies-retrievepolicy.html
+++ b/protocol-examples-policies-retrievepolicy.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1539,7 +1546,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-policies-retrievepolicyentries.html b/protocol-examples-policies-retrievepolicyentries.html
index 296f590..c256203 100644
--- a/protocol-examples-policies-retrievepolicyentries.html
+++ b/protocol-examples-policies-retrievepolicyentries.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1552,7 +1559,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-policies-retrievepolicyentry.html b/protocol-examples-policies-retrievepolicyentry.html
index 963210b..ebb8c89 100644
--- a/protocol-examples-policies-retrievepolicyentry.html
+++ b/protocol-examples-policies-retrievepolicyentry.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1534,7 +1541,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-policies-retrieveresource.html b/protocol-examples-policies-retrieveresource.html
index b34696f..ff017af 100644
--- a/protocol-examples-policies-retrieveresource.html
+++ b/protocol-examples-policies-retrieveresource.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1525,7 +1532,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-policies-retrieveresources.html b/protocol-examples-policies-retrieveresources.html
index 2be5665..1f957bf 100644
--- a/protocol-examples-policies-retrieveresources.html
+++ b/protocol-examples-policies-retrieveresources.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1527,7 +1534,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-policies-retrievesubject.html b/protocol-examples-policies-retrievesubject.html
index a72c71f..eb891e4 100644
--- a/protocol-examples-policies-retrievesubject.html
+++ b/protocol-examples-policies-retrievesubject.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1521,7 +1528,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-policies-retrievesubjects.html b/protocol-examples-policies-retrievesubjects.html
index 793fa81..820bc1f 100644
--- a/protocol-examples-policies-retrievesubjects.html
+++ b/protocol-examples-policies-retrievesubjects.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1523,7 +1530,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-retrieveattribute.html b/protocol-examples-retrieveattribute.html
index 775d038..e6217d5 100644
--- a/protocol-examples-retrieveattribute.html
+++ b/protocol-examples-retrieveattribute.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1518,7 +1525,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-retrieveattributes.html b/protocol-examples-retrieveattributes.html
index f850b80..2ea9cc9 100644
--- a/protocol-examples-retrieveattributes.html
+++ b/protocol-examples-retrieveattributes.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1520,7 +1527,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-retrievedefinition.html b/protocol-examples-retrievedefinition.html
index 362fad4..47f4075 100644
--- a/protocol-examples-retrievedefinition.html
+++ b/protocol-examples-retrievedefinition.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1517,7 +1524,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-retrievefeature.html b/protocol-examples-retrievefeature.html
index 311aadf..2f615ad 100644
--- a/protocol-examples-retrievefeature.html
+++ b/protocol-examples-retrievefeature.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1522,7 +1529,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-retrievefeatures.html b/protocol-examples-retrievefeatures.html
index a878fe6..d54d0ef 100644
--- a/protocol-examples-retrievefeatures.html
+++ b/protocol-examples-retrievefeatures.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1524,7 +1531,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-retrieveproperties.html b/protocol-examples-retrieveproperties.html
index f7db093..2592937 100644
--- a/protocol-examples-retrieveproperties.html
+++ b/protocol-examples-retrieveproperties.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1520,7 +1527,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-retrieveproperty.html b/protocol-examples-retrieveproperty.html
index b0a19bc..634daff 100644
--- a/protocol-examples-retrieveproperty.html
+++ b/protocol-examples-retrieveproperty.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1515,7 +1522,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-retrievething.html b/protocol-examples-retrievething.html
index d3b02a6..c5cb40c 100644
--- a/protocol-examples-retrievething.html
+++ b/protocol-examples-retrievething.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1544,7 +1551,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-retrievethingdefinition.html b/protocol-examples-retrievethingdefinition.html
index 96440fd..3611740 100644
--- a/protocol-examples-retrievethingdefinition.html
+++ b/protocol-examples-retrievethingdefinition.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1515,7 +1522,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-retrievethings.html b/protocol-examples-retrievethings.html
index 2a6a873..c0b9fb3 100644
--- a/protocol-examples-retrievethings.html
+++ b/protocol-examples-retrievethings.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1541,7 +1548,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-search.html b/protocol-examples-search.html
index 0e99157..85604ff 100644
--- a/protocol-examples-search.html
+++ b/protocol-examples-search.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1619,7 +1626,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples.html b/protocol-examples.html
index 356972e..352d4ff 100644
--- a/protocol-examples.html
+++ b/protocol-examples.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1601,7 +1608,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-overview.html b/protocol-overview.html
index 4ff751e..7e266c8 100644
--- a/protocol-overview.html
+++ b/protocol-overview.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1517,7 +1524,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-specification-acks.html b/protocol-specification-acks.html
index 9c11d1c..e19aaa8 100644
--- a/protocol-specification-acks.html
+++ b/protocol-specification-acks.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1541,7 +1548,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-specification-policies-create-or-modify.html b/protocol-specification-policies-create-or-modify.html
index a419c79..a42e9d0 100644
--- a/protocol-specification-policies-create-or-modify.html
+++ b/protocol-specification-policies-create-or-modify.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -2119,7 +2126,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-specification-policies-delete.html b/protocol-specification-policies-delete.html
index d261897..b86d89d 100644
--- a/protocol-specification-policies-delete.html
+++ b/protocol-specification-policies-delete.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1789,7 +1796,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-specification-policies-retrieve.html b/protocol-specification-policies-retrieve.html
index f5ac993..11cf9a0 100644
--- a/protocol-specification-policies-retrieve.html
+++ b/protocol-specification-policies-retrieve.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -2012,7 +2019,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-specification-policies.html b/protocol-specification-policies.html
index f5fd9f4..550fed0 100644
--- a/protocol-specification-policies.html
+++ b/protocol-specification-policies.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1599,7 +1606,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-specification-things-create-or-modify.html b/protocol-specification-things-create-or-modify.html
index 53afb96..325b41e 100644
--- a/protocol-specification-things-create-or-modify.html
+++ b/protocol-specification-things-create-or-modify.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -2919,7 +2926,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-specification-things-delete.html b/protocol-specification-things-delete.html
index 707a248..70db547 100644
--- a/protocol-specification-things-delete.html
+++ b/protocol-specification-things-delete.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -2406,7 +2413,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-specification-things-messages.html b/protocol-specification-things-messages.html
index a13d75e..a6b943e 100644
--- a/protocol-specification-things-messages.html
+++ b/protocol-specification-things-messages.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1761,7 +1768,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-specification-things-retrieve.html b/protocol-specification-things-retrieve.html
index 5fce93a..4c9eca2 100644
--- a/protocol-specification-things-retrieve.html
+++ b/protocol-specification-things-retrieve.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -2208,7 +2215,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-specification-things-search.html b/protocol-specification-things-search.html
index 5166aa8..42ed1f6 100644
--- a/protocol-specification-things-search.html
+++ b/protocol-specification-things-search.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1865,7 +1872,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-specification-things.html b/protocol-specification-things.html
index fd8fa23..f05a1c0 100644
--- a/protocol-specification-things.html
+++ b/protocol-specification-things.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1570,7 +1577,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-specification-topic.html b/protocol-specification-topic.html
index 2fee23c..1c2a76a 100644
--- a/protocol-specification-topic.html
+++ b/protocol-specification-topic.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1675,7 +1682,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-specification.html b/protocol-specification.html
index bd39669..583f527 100644
--- a/protocol-specification.html
+++ b/protocol-specification.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1657,7 +1664,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-twinlive.html b/protocol-twinlive.html
index 0b0db05..2ee2615 100644
--- a/protocol-twinlive.html
+++ b/protocol-twinlive.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1528,7 +1535,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/release_notes_010-M1.html b/release_notes_010-M1.html
index 3612ded..7d5bed4 100644
--- a/release_notes_010-M1.html
+++ b/release_notes_010-M1.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1507,7 +1514,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/release_notes_010-M3.html b/release_notes_010-M3.html
index e39e9cc..4fde1db 100644
--- a/release_notes_010-M3.html
+++ b/release_notes_010-M3.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1563,7 +1570,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/release_notes_020-M1.html b/release_notes_020-M1.html
index 7e49dc5..17dbb28 100644
--- a/release_notes_020-M1.html
+++ b/release_notes_020-M1.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1548,7 +1555,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/release_notes_030-M1.html b/release_notes_030-M1.html
index 2127a75..b163d10 100644
--- a/release_notes_030-M1.html
+++ b/release_notes_030-M1.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1559,7 +1566,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/release_notes_030-M2.html b/release_notes_030-M2.html
index 0fabeed..0a289c4 100644
--- a/release_notes_030-M2.html
+++ b/release_notes_030-M2.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1556,7 +1563,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/release_notes_080-M1.html b/release_notes_080-M1.html
index 8e82059..1efbe41 100644
--- a/release_notes_080-M1.html
+++ b/release_notes_080-M1.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1578,7 +1585,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/release_notes_080-M2.html b/release_notes_080-M2.html
index 35d2c24..60470ea 100644
--- a/release_notes_080-M2.html
+++ b/release_notes_080-M2.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1562,7 +1569,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/release_notes_080-M3.html b/release_notes_080-M3.html
index cea9bea..735c8d7 100644
--- a/release_notes_080-M3.html
+++ b/release_notes_080-M3.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1566,7 +1573,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/release_notes_080.html b/release_notes_080.html
index 068aece..56599e3 100644
--- a/release_notes_080.html
+++ b/release_notes_080.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1572,7 +1579,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/release_notes_090-M1.html b/release_notes_090-M1.html
index bbdab77..4dc07ef 100644
--- a/release_notes_090-M1.html
+++ b/release_notes_090-M1.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1544,7 +1551,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/release_notes_090-M2.html b/release_notes_090-M2.html
index b09bf64..11566bd 100644
--- a/release_notes_090-M2.html
+++ b/release_notes_090-M2.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1545,7 +1552,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/release_notes_090.html b/release_notes_090.html
index 1767dcd..fa97a5a 100644
--- a/release_notes_090.html
+++ b/release_notes_090.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1602,7 +1609,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/release_notes_100-M1a.html b/release_notes_100-M1a.html
index 4033f0d..5040d3c 100644
--- a/release_notes_100-M1a.html
+++ b/release_notes_100-M1a.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1563,7 +1570,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/release_notes_100-M2.html b/release_notes_100-M2.html
index ea79e7c..163c7f6 100644
--- a/release_notes_100-M2.html
+++ b/release_notes_100-M2.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1580,7 +1587,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/release_notes_100.html b/release_notes_100.html
index f117a67..617fd6d 100644
--- a/release_notes_100.html
+++ b/release_notes_100.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1485,7 +1492,7 @@
expressed are correct, licensing is valid and compatible, and that other issues have been uncovered and properly
investigated.”</p>
-<h2 id="whats-in-this-release">What’s in this release?</h2>
+<h2 id="changelog">Changelog</h2>
<p>Eclipse Ditto 1.0.0 focuses on the following areas:</p>
@@ -1498,22 +1505,20 @@
If you want to upgrade an existing Ditto installation to 1.0.0, the following database migration has to be done
before upgrading: <strong>Follow the steps documented in <a href="#migration-notes">the migration notes</a></strong>.</div>
-<h3 id="changelog">Changelog</h3>
-
<p>Compared to the latest milestone release <a href="release_notes_100-M2.html">1.0.0-M2</a>, the following changes, new features and
bugfixes were added.</p>
-<h4 id="changes">Changes</h4>
+<h3 id="changes">Changes</h3>
-<h5 id="remove-suffixed-collections"><a href="https://github.com/eclipse/ditto/issues/537">Remove suffixed collections</a></h5>
+<h4 id="remove-suffixed-collections"><a href="https://github.com/eclipse/ditto/issues/537">Remove suffixed collections</a></h4>
<p>We removed suffixed collection support from Things and Policies persistence.
These collections do not scale well with increased amount of namespaces and lead to massive problems with mongodb as
sharding can’t be used.</p>
-<h4 id="new-features">New features</h4>
+<h3 id="new-features">New features</h3>
-<h5 id="comprehensive-support-for-command-responses"><a href="https://github.com/eclipse/ditto/issues/540">Comprehensive support for command responses</a></h5>
+<h4 id="comprehensive-support-for-command-responses"><a href="https://github.com/eclipse/ditto/issues/540">Comprehensive support for command responses</a></h4>
<p>Adds the possibility to define a “reply target” for <a href="basic-connections.html#sources">connection sources</a> where</p>
<ul>
@@ -1527,19 +1532,19 @@
<p>Used in combination with <a href="https://eclipse.org/hono/">Eclipse Hono</a> it is possible to send responses to devices which
e.g. need to retrieve data from Ditto.</p>
-<h5 id="add-definition-to-thing-in-order-to-reference-used-model"><a href="https://github.com/eclipse/ditto/issues/247">Add “definition” to Thing in order to reference used model</a></h5>
+<h4 id="add-definition-to-thing-in-order-to-reference-used-model"><a href="https://github.com/eclipse/ditto/issues/247">Add “definition” to Thing in order to reference used model</a></h4>
<p>In order to specify which model a Thing follows, the JSON of the Thing entity was enhanced with a single string for
<code class="highlighter-rouge">"definintion"</code>. This can e.g. be used in order to place an <a href="https://eclipse.org/vorto/">Eclipse Vorto</a>
“Information Model” reference to a Thing.</p>
-<h4 id="bugfixes">Bugfixes</h4>
+<h3 id="bugfixes">Bugfixes</h3>
-<h5 id="fixed-nullpointer-in-streamingsessionactor"><a href="https://github.com/eclipse/ditto/pull/546">Fixed NullPointer in StreamingSessionActor</a></h5>
+<h4 id="fixed-nullpointer-in-streamingsessionactor"><a href="https://github.com/eclipse/ditto/pull/546">Fixed NullPointer in StreamingSessionActor</a></h4>
<p>When closing a WebSocket session, a <code class="highlighter-rouge">NullPointerException</code> occurred which is fixed now.</p>
-<h3 id="migration-notes">Migration notes</h3>
+<h2 id="migration-notes">Migration notes</h2>
<p>OpenID Connect URLs are now prefixed with <code class="highlighter-rouge">https://</code> per default. Any configured URLs containing <code class="highlighter-rouge">https://</code> will break the configuration.
Instead of <code class="highlighter-rouge">https://auth.eclipse.de/auth/realms/ditto</code> it has to be <code class="highlighter-rouge">auth.eclipse.de/auth/realms/ditto</code> instead.
@@ -1585,7 +1590,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/release_notes_110.html b/release_notes_110.html
index 3f337aa..9c6991c 100644
--- a/release_notes_110.html
+++ b/release_notes_110.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1483,16 +1490,14 @@
<p>It is API and <a href="https://github.com/eclipse/ditto/blob/master/documentation/src/main/resources/architecture/DADR-0005-semantic-versioning.md">binary compatible</a>
to Eclipse Ditto 1.0.0.</p>
-<h2 id="whats-in-this-release">What’s in this release?</h2>
-
-<h3 id="changelog">Changelog</h3>
+<h2 id="changelog">Changelog</h2>
<p>Compared to the latest release <a href="release_notes_100.html">1.0.0</a>, the following changes, new features and
bugfixes were added.</p>
-<h4 id="changes">Changes</h4>
+<h3 id="changes">Changes</h3>
-<h5 id="java-11-as-runtime-environment"><a href="https://github.com/eclipse/ditto/issues/308">Java 11 as runtime environment</a></h5>
+<h4 id="java-11-as-runtime-environment"><a href="https://github.com/eclipse/ditto/issues/308">Java 11 as runtime environment</a></h4>
<p>The default Java runtime for Ditto’s Docker containers was switched from Java 8 to Java 11 which should have some
benefits in storing Strings in memory (this was already added in Java 9).</p>
@@ -1501,7 +1506,7 @@
for <a href="https://github.com/eclipse/ditto/blob/master/documentation/src/main/resources/architecture/DADR-0005-semantic-versioning.md">semantic versioning</a>
are still compatible to Java 8.</p>
-<h5 id="cbor-as-ditto-internal-serialization-provider"><a href="https://github.com/eclipse/ditto/pull/598">CBOR as Ditto internal serialization provider</a></h5>
+<h4 id="cbor-as-ditto-internal-serialization-provider"><a href="https://github.com/eclipse/ditto/pull/598">CBOR as Ditto internal serialization provider</a></h4>
<p>As a bachelor thesis, <a href="https://github.com/erikescher">Erik Escher</a> evaluated mechanisms to improve the serialization
overhead done in Ditto clusters.</p>
@@ -1510,15 +1515,15 @@
roundtrip times and throughput.
The Ditto team was happy to accept his pull request, again improving overall performance in Ditto.</p>
-<h5 id="more-strict-content-type-parsing-for-http-request-payload"><a href="https://github.com/eclipse/ditto/pull/650">More strict Content-Type parsing for HTTP request payload</a></h5>
+<h4 id="more-strict-content-type-parsing-for-http-request-payload"><a href="https://github.com/eclipse/ditto/pull/650">More strict Content-Type parsing for HTTP request payload</a></h4>
<p>In the past, Ditto did not evaluate the HTTP <code class="highlighter-rouge">Content-Type</code> header of HTTP requests sending along payload. As this
can be a potential security issue (e.g. in scope of CORS requests), the <code class="highlighter-rouge">Content-Type</code> is now strictly enforced to
be of <code class="highlighter-rouge">application/json</code> wherever Ditto only accepts JSON request payload.</p>
-<h4 id="new-features">New features</h4>
+<h3 id="new-features">New features</h3>
-<h5 id="management-of-policies-via-ditto-protocol-and-in-java-client"><a href="https://github.com/eclipse/ditto/issues/554">Management of policies via Ditto Protocol and in Java client</a></h5>
+<h4 id="management-of-policies-via-ditto-protocol-and-in-java-client"><a href="https://github.com/eclipse/ditto/issues/554">Management of policies via Ditto Protocol and in Java client</a></h4>
<p>The <a href="basic-policy.html">policy</a> entities can now - in addition to their HTTP API - be managed via the
<a href="protocol-specification-policies.html">Ditto Protocol</a>. That means also via
@@ -1527,7 +1532,7 @@
<p>APIs for <a href="client-sdk-java.html#manage-policies">policy management</a> were also added to the
<a href="https://github.com/eclipse/ditto-clients/pull/46">Ditto Java Client</a>.</p>
-<h5 id="searching-things-via-ditto-protocol-and-in-java-client"><a href="https://github.com/eclipse/ditto/issues/575">Searching things via Ditto Protocol and in Java client</a></h5>
+<h4 id="searching-things-via-ditto-protocol-and-in-java-client"><a href="https://github.com/eclipse/ditto/issues/575">Searching things via Ditto Protocol and in Java client</a></h4>
<p>New <a href="protocol-specification-things-search.html">Ditto Protocol for search</a> was added in order to define a search query
via the Ditto Protocol and also get results via an asynchronous channel. As a result, searching for things is now also
@@ -1537,7 +1542,7 @@
<p>APIs for <a href="client-sdk-java.html#search-for-things">searching things</a> were also added to the
<a href="https://github.com/eclipse/ditto-clients/pull/53">Ditto Java Client</a>.</p>
-<h5 id="enriching-messages-and-events-before-publishing-to-external-subscribers"><a href="https://github.com/eclipse/ditto/issues/561">Enriching messages and events before publishing to external subscribers</a></h5>
+<h4 id="enriching-messages-and-events-before-publishing-to-external-subscribers"><a href="https://github.com/eclipse/ditto/issues/561">Enriching messages and events before publishing to external subscribers</a></h4>
<p>When subscribing <a href="basic-changenotifications.html">change notifications</a> or for messages to publish to external system or
deliver via <a href="httpapi-protocol-bindings-websocket.html">WebSocket</a> it is now possible to <a href="basic-enrichment.html">enrich</a>
@@ -1549,7 +1554,7 @@
<p>APIs for <a href="client-sdk-java.html#subscribe-to-enriched-change-notifications">enriching changes</a> were also added to the
<a href="https://github.com/eclipse/ditto-clients/pull/43">Ditto Java Client</a>.</p>
-<h5 id="establish-connections-to-mqtt-5-brokers"><a href="https://github.com/eclipse/ditto/issues/561">Establish connections to MQTT 5 brokers</a></h5>
+<h4 id="establish-connections-to-mqtt-5-brokers"><a href="https://github.com/eclipse/ditto/issues/561">Establish connections to MQTT 5 brokers</a></h4>
<p>The Ditto community (namely <a href="https://github.com/w4tsn">Alexander Wellbrock (w4tsn)</a> from
<a href="https://www.othermo.de">othermo GmbH</a>) contributed MQTT 5 support to Ditto’s connectivity capabilities.<br />
@@ -1558,7 +1563,7 @@
<p>Thank you very much for this great contribution.</p>
-<h5 id="end-2-end-acknowledgements"><a href="https://github.com/eclipse/ditto/issues/611">End-2-end acknowledgements</a></h5>
+<h4 id="end-2-end-acknowledgements"><a href="https://github.com/eclipse/ditto/issues/611">End-2-end acknowledgements</a></h4>
<p>Until now, messages consumed by Eclipse Ditto were processed without a guarantee. That is being addressed with this
first feature addition, the model and logic in order to request and emit <a href="basic-acknowledgements.html">acknowledgements</a>.</p>
@@ -1570,15 +1575,15 @@
<p>APIs for <a href="client-sdk-java.html#request-and-issue-acknowledgements">requesting and issuing acknowledgements</a> were also
added to the <a href="https://github.com/eclipse/ditto-clients/pull/56">Ditto Java Client</a>.</p>
-<h5 id="pre-authenticated-authentication-mechanism"><a href="https://github.com/eclipse/ditto/issues/560">Pre-authenticated authentication mechanism</a></h5>
+<h4 id="pre-authenticated-authentication-mechanism"><a href="https://github.com/eclipse/ditto/issues/560">Pre-authenticated authentication mechanism</a></h4>
<p>Officially added+<a href="installation-operating.html#pre-authentication">documented</a> support of how Ditto external
authentication providers may be configured to authenticate users in Ditto by adding them as an HTTP reverse proxy in
front of Ditto.</p>
-<h4 id="deprecations">Deprecations</h4>
+<h3 id="deprecations">Deprecations</h3>
-<h5 id="api-version-1-deprecation"><a href="https://github.com/eclipse/ditto/pull/608">API version 1 deprecation</a></h5>
+<h4 id="api-version-1-deprecation"><a href="https://github.com/eclipse/ditto/pull/608">API version 1 deprecation</a></h4>
<p>Now that Ditto has a full replacement for <a href="basic-acl.html">ACLs</a>, namely <a href="basic-policy.html">policies</a> which now can
also be managed via the <a href="protocol-specification-policies.html">Ditto Protocol</a> and the
@@ -1591,13 +1596,13 @@
<p>So when you start using Ditto, please make sure to use API version <code class="highlighter-rouge">2</code> (using policies as
<a href="basic-auth.html#authorization">authorization mechanism</a>) from the very beginning.</p>
-<h4 id="bugfixes">Bugfixes</h4>
+<h3 id="bugfixes">Bugfixes</h3>
<p>Several bugs in Ditto 1.0.0 were fixed for 1.1.0.<br />
This is a complete list of the
<a href="https://github.com/eclipse/ditto/pulls?q=is%3Apr+milestone%3A1.1.0">merged pull requests</a>, including the fixed bugs.</p>
-<h3 id="migration-notes">Migration notes</h3>
+<h2 id="migration-notes">Migration notes</h2>
<p>Do not apply when updating from Eclipse Ditto 1.0.0 to 1.1.0.</p>
@@ -1626,7 +1631,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/release_notes_111.html b/release_notes_111.html
index 7197c54..e022301 100644
--- a/release_notes_111.html
+++ b/release_notes_111.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li class="active"><a href="release_notes_111.html">1.1.1</a></li>
@@ -1478,15 +1485,22 @@
- <p>This is a bugifx release needed for the Ditto Java SDK.</p>
+ <p>This is a bugfix release needed for the Ditto Java SDK, no new features since <a href="release_notes_110.html">1.1.0</a> were added.</p>
-<h2 id="bugfixes">Bugfixes</h2>
+<h2 id="changelog">Changelog</h2>
-<h3 id="allow-to-respond-to-live-messages-via-ditto-client"><a href="https://github.com/eclipse/ditto-clients/pull/60">Allow to respond to live messages via ditto client</a></h3>
+<p>Compared to the latest release <a href="release_notes_110.html">1.1.0</a>, the following bugfixes were added.</p>
+
+<h3 id="bugfixes">Bugfixes</h3>
+
+<p>This is a complete list of the
+<a href="https://github.com/eclipse/ditto/pulls?q=is%3Apr+milestone%3A1.1.1">merged pull requests</a>, including the fixed bugs.</p>
+
+<h4 id="allow-to-respond-to-live-messages-via-ditto-client"><a href="https://github.com/eclipse/ditto-clients/pull/60">Allow to respond to live messages via ditto client</a></h4>
<p>Don’t force response-required to be false when calling send() without response consumer.</p>
-<h3 id="header-mapping"><a href="https://github.com/eclipse/ditto/pull/671">Header mapping</a></h3>
+<h4 id="header-mapping"><a href="https://github.com/eclipse/ditto/pull/671">Header mapping</a></h4>
<p>Remove filtering of unknown headers for adaptables. We need those headers for header mapping in connectivity.</p>
@@ -1515,7 +1529,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/release_notes_112.html b/release_notes_112.html
new file mode 100644
index 0000000..0b99f24
--- /dev/null
+++ b/release_notes_112.html
@@ -0,0 +1,1584 @@
+<!DOCTYPE html>
+<html>
+<head>
+ <meta charset="utf-8">
+<meta http-equiv="X-UA-Compatible" content="IE=edge">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="description" content="Version 1.1.2 of Eclipse Ditto, released on 01.07.2020">
+<meta name="keywords" content="release_notes, release notes, announcements, changelog">
+<title> Release notes 1.1.2 • Eclipse Ditto • a digital twin framework</title>
+
+<link rel="stylesheet" href="css/syntax.css">
+<link rel="stylesheet" type="text/css" href="//cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/modern-business.css">
+<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/customstyles.css">
+<link rel="stylesheet" href="css/boxshadowproperties.css">
+<link rel="stylesheet" href="css/theme-ditto.css">
+<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:400,700|Source+Code+Pro:300,600|Titillium+Web:400,600,700">
+
+<script src="//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.4/jquery.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/js/bootstrap.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/anchor-js/2.0.0/anchor.min.js" crossorigin="anonymous"></script>
+<script src="js/toc.js"></script>
+<script src="js/customscripts.js"></script>
+
+<script type="application/ld+json">
+{
+ "@context": "http://schema.org",
+ "@type": "Organization",
+ "url": "https://eclipse.org/ditto/",
+ "logo": "https://eclipse.org/ditto/images/ditto.svg"
+}
+</script>
+
+<link rel="icon" type="image/png" href="images/favicon-16x16.png" sizes="16x16">
+<link rel="icon" type="image/png" href="images/favicon-32x32.png" sizes="32x32">
+<link rel="icon" type="image/png" href="images/favicon-96x96.png" sizes="96x96">
+
+<link rel="alternate" type="application/rss+xml" title="Eclipse Ditto Blog" href="https://www.eclipse.org/ditto/feed.xml">
+
+<!-- Eclipse Foundation cookie consent: -->
+<link rel="stylesheet" type="text/css" href="//www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css" />
+<script src="//www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+ <script>
+ $(document).ready(function() {
+ $("#tg-sb-link").click(function() {
+ $("#tg-sb-sidebar").toggle();
+ $("#tg-sb-content").toggleClass('col-md-9');
+ $("#tg-sb-content").toggleClass('col-md-12');
+ $("#tg-sb-icon").toggleClass('fa-toggle-on');
+ $("#tg-sb-icon").toggleClass('fa-toggle-off');
+ });
+ });
+ </script>
+</head>
+
+
+<script>
+ (function(w,d,s,l,i){
+ w[l]=w[l]||[];
+ w[l].push({'gtm.start':
+ new Date().getTime(),event:'gtm.js'});
+ var f=d.getElementsByTagName(s)[0],
+ j=d.createElement(s),
+ dl=l!='dataLayer'?'&l='+l:'';
+ j.async=true;
+ j.src='https://www.googletagmanager.com/gtm.js?id='+i+dl;
+ f.parentNode.insertBefore(j,f);
+ })(window,document,'script','dataLayer','GTM-5WLCZXC');
+</script>
+
+
+
+<body>
+<!-- Navigation -->
+<nav class="navbar navbar-inverse navbar-fixed-top">
+ <div class="container topnavlinks">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-ditto-home" href="index.html"> <img src="images/ditto_allwhite_symbolonly.svg" class="ditto-navbar-symbol" alt="Home"> <img src="images/ditto_allwhite_textonly.svg" class="ditto-navbar-symbol-text" alt="Ditto"></a>
+ </div>
+ <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
+ <ul class="nav navbar-nav navbar-right">
+ <!-- toggle sidebar button -->
+ <!--<li><a id="tg-sb-link" href="#"><i id="tg-sb-icon" class="fa fa-toggle-on"></i> Nav</a></li>-->
+ <!-- entries without drop-downs appear here -->
+
+
+
+
+
+
+
+ <li><a href="blog.html">Blog</a></li>
+
+
+
+ <li><a href="intro-overview.html">Documentation</a></li>
+
+
+
+ <li><a href="http-api-doc.html">HTTP API</a></li>
+
+
+
+ <li><a href="https://ditto.eclipse.org" target="_blank">Sandbox</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">GitHub</a></li>
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">GitHub examples</a></li>
+
+
+
+ <!-- entries with drop-downs appear here -->
+ <!-- conditional logic to control which topnav appears for the audience defined in the configuration file.-->
+
+
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Links<b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+
+ <li><a href="https://projects.eclipse.org/projects/iot.ditto" target="_blank">Eclipse Ditto Project</a></li>
+
+
+
+ <li><a href="https://www.eclipse.org/forums/index.php/f/364/" target="_blank">Forum</a></li>
+
+
+
+ <li><a href="https://ci.eclipse.org/ditto/" target="_blank">Jenkins</a></li>
+
+
+
+ <li><a href="https://dev.eclipse.org/mhonarc/lists/ditto-dev/" target="_blank">Mailing list archives</a></li>
+
+
+
+ <li><a href="https://gitter.im/eclipse/ditto" target="_blank">Gitter.im chat</a></li>
+
+
+ </ul>
+ </li>
+
+
+
+ <!--comment out this block if you want to hide search-->
+ <li>
+ <!--start search-->
+ <div id="search-demo-container">
+ <input type="text" id="search-input" placeholder="search...">
+ <ul id="results-container"></ul>
+ </div>
+ <script src="//cdnjs.cloudflare.com/ajax/libs/simple-jekyll-search/0.0.9/jekyll-search.js" type="text/javascript"></script>
+ <script type="text/javascript">
+ SimpleJekyllSearch.init({
+ searchInput: document.getElementById('search-input'),
+ resultsContainer: document.getElementById('results-container'),
+ dataSource: 'search.json',
+ searchResultTemplate: '<li><a href="{url}" title="Release notes 1.1.2">{title}</a></li>',
+ noResultsText: 'No results found.',
+ limit: 10,
+ fuzzy: true,
+ })
+ </script>
+ <!--end search-->
+ </li>
+ </ul>
+ </div>
+ </div>
+ <!-- /.container -->
+</nav>
+
+<!-- Page Content -->
+<div class="container">
+ <div id="main">
+ <!-- Content Row -->
+ <div class="row">
+
+
+ <!-- Sidebar Column -->
+ <div class="col-md-3" id="tg-sb-sidebar">
+
+
+<ul id="mysidebar" class="nav">
+ <li class="sidebarTitle">
+ <label for="docVersion">Eclipse Ditto version:</label>
+ <div class="select-wrapper">
+ <select id="docVersion" name="docVersion">
+
+ <option value="">development</option>
+
+ <option value="1.0">1.0</option>
+
+ <option value="1.1">1.1</option>
+
+ </select>
+ </div>
+ <div id="dev-warning">
+ <div markdown="span" class="alert alert-warning" role="alert" style="font-size:0.6em"><i class="fa fa-warning"></i> <b>Important:</b> This documentation reflects the latest 'development'. You might want to choose a released version.</div>
+ </div>
+ </li>
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Introduction</a>
+ <ul>
+
+
+
+ <li><a href="intro-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="intro-digitaltwins.html">Digital twins</a></li>
+
+
+
+
+
+
+ <li><a href="intro-hello-world.html">Hello world</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Release Notes</a>
+ <ul>
+
+
+
+ <li class="active"><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_111.html">1.1.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_110.html">1.1.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_100.html">1.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_090.html">0.9.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_080.html">0.8.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Milestone releases</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_100-M2.html">1.0.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_100-M1a.html">1.0.0-M1a</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M2.html">0.9.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_090-M1.html">0.9.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M3.html">0.8.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M2.html">0.8.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080-M1.html">0.8.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M2.html">0.3.0-M2</a></li>
+
+
+
+
+
+ <li><a href="release_notes_030-M1.html">0.3.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_020-M1.html">0.2.0-M1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M3.html">0.1.0-M3</a></li>
+
+
+
+
+
+ <li><a href="release_notes_010-M1.html">0.1.0-M1</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Installation</a>
+ <ul>
+
+
+
+ <li><a href="installation-building.html">Building Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-running.html">Running Ditto</a></li>
+
+
+
+
+
+
+ <li><a href="installation-operating.html">Operating Ditto</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Basic concepts</a>
+ <ul>
+
+
+
+ <li><a href="basic-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Model entities</a>
+ <ul>
+
+
+
+ <li><a href="basic-thing.html">Thing</a></li>
+
+
+
+
+
+ <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
+
+
+
+
+
+ <li><a href="basic-feature.html">Feature</a></li>
+
+
+
+
+
+ <li><a href="basic-policy.html">Policy</a></li>
+
+
+
+
+
+ <li><a href="basic-namespaces-and-names.html">Namespaces and Names</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-auth.html">Authentication and Authorization</a></li>
+
+
+
+
+
+
+ <li><a href="basic-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="basic-signals.html">Signals</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Signal types</a>
+ <ul>
+
+
+
+ <li><a href="basic-signals-command.html">Command</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-commandresponse.html">Command response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-errorresponse.html">Error response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-event.html">Event</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-apis.html">APIs</a></li>
+
+
+
+
+
+
+ <li><a href="basic-connections.html">Connections</a></li>
+
+
+
+
+
+
+ <li><a href="basic-placeholders.html">Placeholders</a></li>
+
+
+
+
+
+
+ <li><a href="basic-changenotifications.html">Change notifications</a></li>
+
+
+
+
+
+
+ <li><a href="basic-rql.html">RQL expressions</a></li>
+
+
+
+
+
+
+ <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+
+
+
+
+
+
+ <li><a href="basic-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Architecture</a>
+ <ul>
+
+
+
+ <li><a href="architecture-overview.html">Overview</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Services</a>
+ <ul>
+
+
+
+ <li><a href="architecture-services-policies.html">Policies</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things.html">Things</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-things-search.html">Things-Search</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-connectivity.html">Connectivity</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-concierge.html">Concierge</a></li>
+
+
+
+
+
+ <li><a href="architecture-services-gateway.html">Gateway</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>HTTP API</a>
+ <ul>
+
+
+
+ <li><a href="httpapi-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-concepts.html">Concepts</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-messages.html">Messages</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-protocol-bindings-websocket.html">WebSocket protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-sse.html">Server sent events</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Connectivity API</a>
+ <ul>
+
+
+
+ <li><a href="connectivity-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-manage-connections.html">Manage connections</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp091.html">AMQP 0.9.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-amqp10.html">AMQP 1.0 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-protocol-bindings-kafka2.html">Kafka 2.x protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-mapping.html">Payload mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-header-mapping.html">Header mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-tls-certificates.html">TLS certificates</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Client SDK</a>
+ <ul>
+
+
+
+ <li><a href="client-sdk-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-java.html">Java</a></li>
+
+
+
+
+
+
+ <li><a href="client-sdk-javascript.html">JavaScript</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Ditto Protocol</a>
+ <ul>
+
+
+
+ <li><a href="protocol-overview.html">Overview</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-twinlive.html">Twin/live channel</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification.html">Specification</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-topic.html">Protocol topic</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-things.html">Things group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-delete.html">Delete</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ search/messages</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-things-search.html">Search</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-messages.html">Messages</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-policies.html">Policies group</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ commands/events</a>
+ <ul>
+
+
+
+ <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-bindings.html">Bindings</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-examples.html">Examples</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-creatething.html">Create a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletething.html">Delete a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifything.html">Modify a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievething.html">Retrieve a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethings.html">Retrieve multiple Things</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattributes.html">Delete Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattributes.html">Modify Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattributes.html">Retrieve Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createattribute.html">Create a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteattribute.html">Delete a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyattribute.html">Modify a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveattribute.html">Retrieve a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createthingdefinition.html">Create a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletethingdefinition.html">Delete a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifythingdefinition.html">Modify a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievethingdefinition.html">Retrieve a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeatures.html">Create Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeatures.html">Delete Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeatures.html">Modify Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeatures.html">Retrieve Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createfeature.html">Create a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletefeature.html">Delete a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyfeature.html">Modify a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievefeature.html">Retrieve a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdefinition.html">Create Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedefinition.html">Delete Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydefinition.html">Modify Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedefinition.html">Retrieve Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperties.html">Create Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperties.html">Delete Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperties.html">Modify Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperties.html">Retrieve Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createproperty.html">Create a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deleteproperty.html">Delete a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifyproperty.html">Modify a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrieveproperty.html">Retrieve a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Policies examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li><a href="sandbox.html">Sandbox</a></li>
+
+
+
+
+
+ <li><a href="presentations.html">Presentations</a></li>
+
+
+
+
+
+ <li><a href="glossary.html">Glossary</a></li>
+
+
+
+
+
+ <li><a href="feedback.html">Feedback</a></li>
+
+
+
+
+
+ <p class="external">
+ <a href="#" id="collapseAll">Collapse All</a> | <a href="#" id="expandAll">Expand All</a>
+ </p>
+
+</ul>
+
+<!-- this highlights the active parent class in the sidebar. this is critical so that the parent expands when you're viewing a page. This must appear below the sidebar code above. Otherwise, if placed inside customscripts.js, the script runs before the sidebar code runs and the class never gets inserted.-->
+<script>$("li.active").parents('li').toggleClass("active");
+
+$(function() {
+ $("#dev-warning").hide();
+ changeSelectedDocVersionDropdownSelection($("#docVersion")[0]);
+ $("#docVersion").change(changeSelectedDocVersion);
+});
+
+function changeSelectedDocVersionDropdownSelection(element) {
+ var pathName = window.location.pathname;
+
+ var versionOptions = element.options;
+ for (var i = 0; i < versionOptions.length; i++) {
+ var versionValue = versionOptions[i].value;
+ if ((versionValue !== "") && pathName.startsWith("/ditto/"+versionValue+"/")) {
+ $("#docVersion").val(versionValue).change();
+ return;
+ }
+ }
+ // fallback: dev with "empty" version value:
+ $("#docVersion").val("").change();
+ $("#dev-warning").show();
+}
+function changeSelectedDocVersion() {
+ var versionValue = $('#docVersion').val();
+ var remainingPath = window.location.pathname.replace("/ditto/", "");
+ var versionMatch = remainingPath.match("([0-9].[0.9])/(.*)");
+ if (versionValue === "" && !versionMatch) {
+ // do nothing, we're already on the correct "dev" version
+ } else if (versionMatch && (versionValue === versionMatch[1])) {
+ // do nothing, we're already on the correct version
+ } else {
+ if (versionValue === "" && versionMatch) {
+ window.location.pathname = "ditto/" + versionMatch[2];
+ } else if (versionValue === "") {
+ window.location.pathname = "ditto/" + remainingPath;
+ } else if (versionMatch) {
+ window.location.pathname = "ditto/" + versionValue + "/" + versionMatch[2];
+ } else {
+ window.location.pathname = "ditto/" + versionValue + "/" + remainingPath;
+ }
+ }
+}
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Release notes 1.1.2</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+ <div class="summary">Version 1.1.2 of Eclipse Ditto, released on 01.07.2020</div>
+
+
+
+
+<!-- this handles the automatic toc. use ## for subheads to auto-generate the on-page minitoc. if you use html tags, you must supply an ID for the heading element in order for it to appear in the minitoc. -->
+<script>
+$( document ).ready(function() {
+ // Handler for .ready() called.
+
+$('#toc').toc({ minimumHeaders: 0, listType: 'ul', showSpeed: 0, headers: 'h2,h3,h4' });
+
+/* this offset helps account for the space taken up by the floating toolbar. */
+$('#toc').on('click', 'a', function() {
+ var target = $(this.getAttribute('href'))
+ , scroll_target = target.offset().top
+
+ $(window).scrollTop(scroll_target - 10);
+ return false
+})
+
+});
+</script>
+
+<div id="toc"></div>
+
+
+
+
+
+
+
+
+
+ <p>This is a bugfix release, no new features since <a href="release_notes_111.html">1.1.1</a> were added.</p>
+
+<h2 id="changelog">Changelog</h2>
+
+<p>Compared to the latest release <a href="release_notes_111.html">1.1.1</a>, the following changes and bugfixes were added.</p>
+
+<h3 id="changes">Changes</h3>
+
+<h4 id="publish-minor-and-micro-version-tags-to-docker-hub"><a href="https://github.com/eclipse/ditto/pull/693">Publish minor and micro version tags to Docker Hub</a></h4>
+
+<p>Starting with Ditto 1.1.2, the Docker images built and pushed to Docker Hub are:</p>
+<ul>
+ <li>full version (e.g. <code class="highlighter-rouge">1.1.2</code>)</li>
+ <li>minor version (e.g. <code class="highlighter-rouge">1.1</code>)</li>
+ <li>major version (e.g. <code class="highlighter-rouge">1</code>)</li>
+ <li><code class="highlighter-rouge">latest</code></li>
+</ul>
+
+<h3 id="bugfixes">Bugfixes</h3>
+
+<p>This is a complete list of the
+<a href="https://github.com/eclipse/ditto/pulls?q=is%3Apr+milestone%3A1.1.2">merged pull requests</a>, including the fixed bugs.</p>
+
+<h4 id="fix-nullpointerexception-when-disabling-validation-of-certificates-in-connections"><a href="https://github.com/eclipse/ditto/pull/688">Fix NullPointerException when disabling validation of certificates in connections</a></h4>
+
+<p>Fixed <a href="https://github.com/eclipse/ditto/issues/679">Mqtt 3 connection without using certificate validation</a>.</p>
+
+<h4 id="connection-creation-timeout"><a href="https://github.com/eclipse/ditto/pull/692">Connection creation timeout</a></h4>
+
+<p>There was an issue where sometimes the creation of a connection entity failed with a timeout just because the establishing of the actual connection took too much time.</p>
+
+<h4 id="minor-improvements-to-throughputperformance"><a href="https://github.com/eclipse/ditto/pull/689">Minor improvements to throughput/performance</a></h4>
+
+<p>Some minor overall simplifications and performance improvements.</p>
+
+
+ <div class="tags">
+
+ <b>Tags: </b>
+
+
+
+ <a href="tag_release_notes.html" class="btn btn-default navbar-btn cursorNorm" role="button">release_notes</a>
+
+
+
+ </div>
+
+</div>
+
+<hr class="shaded"/>
+
+<footer>
+ <div class="row">
+ <div class="col-lg-12 footer">
+ <div class="logo">
+ <a href="https://eclipse.org"><img src="images/eclipse_foundation_logo.svg" alt="Eclipse logo"/></a>
+ </div>
+ <p class="notice">
+ ©2020 Eclipse Ditto.
+ Site last generated: Jul 1, 2020 <br />
+ </p>
+ <div class="quickLinks">
+ <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
+ > Privacy Policy
+ </a>
+ <a href="https://www.eclipse.org/legal/termsofuse.php" target="_blank">
+ > Terms of Use
+ </a>
+ <a href="https://www.eclipse.org/legal/copyright.php" target="_blank">
+ > Copyright Agent
+ </a>
+ <a href="https://www.eclipse.org/legal" target="_blank">
+ > Legal
+ </a>
+ <a href="https://www.eclipse.org/legal/epl-2.0/" target="_blank">
+ > License
+ </a>
+ <a href="https://eclipse.org/security" target="_blank">
+ > Report a Vulnerability
+ </a>
+ </div>
+ </div>
+ </div>
+</footer>
+
+
+ </div>
+ <!-- /.row -->
+</div>
+<!-- /.container -->
+</div>
+<!-- /#main -->
+ </div>
+
+</body>
+</html>
diff --git a/sandbox.html b/sandbox.html
index 083f7b1..36c2b6a 100644
--- a/sandbox.html
+++ b/sandbox.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -1552,7 +1559,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/search.json b/search.json
index ffd16e3..b40b46c 100644
--- a/search.json
+++ b/search.json
@@ -1177,6 +1177,17 @@
{
+"title": "Release notes 1.1.2",
+"tags": "release_notes",
+"keywords": "release notes, announcements, changelog",
+"url": "release_notes_112.html",
+"summary": "Version 1.1.2 of Eclipse Ditto, released on 01.07.2020"
+}
+,
+
+
+
+{
"title": "Sandbox",
"tags": "",
"keywords": "sandbox, demo, trial",
diff --git a/sitemap.xml b/sitemap.xml
index cd5f6b7..4d7b1eb 100644
--- a/sitemap.xml
+++ b/sitemap.xml
@@ -874,6 +874,12 @@
<url>
+ <loc>https://www.eclipse.org/ditto/release_notes_112.html</loc>
+ </url>
+
+
+
+ <url>
<loc>https://www.eclipse.org/ditto/sandbox.html</loc>
</url>
diff --git a/tag_architecture.html b/tag_architecture.html
index 4d298e4..4fbe5f2 100644
--- a/tag_architecture.html
+++ b/tag_architecture.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -2078,6 +2085,10 @@
+
+
+
+
@@ -2262,7 +2273,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/tag_blog.html b/tag_blog.html
index 82a30b4..8f3b4a2 100644
--- a/tag_blog.html
+++ b/tag_blog.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -2036,6 +2043,10 @@
+
+
+
+
@@ -2388,7 +2399,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/tag_client_sdk.html b/tag_client_sdk.html
index 801098d..4bb7956 100644
--- a/tag_client_sdk.html
+++ b/tag_client_sdk.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -2064,6 +2071,10 @@
+
+
+
+
@@ -2248,7 +2259,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/tag_connectivity.html b/tag_connectivity.html
index 1697a7b..e3309ae 100644
--- a/tag_connectivity.html
+++ b/tag_connectivity.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -2126,6 +2133,10 @@
+
+
+
+
@@ -2334,7 +2345,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/tag_getting_started.html b/tag_getting_started.html
index 382a42b..2f11f2a 100644
--- a/tag_getting_started.html
+++ b/tag_getting_started.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -2078,6 +2085,10 @@
+
+
+
+
@@ -2262,7 +2273,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/tag_http.html b/tag_http.html
index 89eb722..a5f1766 100644
--- a/tag_http.html
+++ b/tag_http.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -2072,6 +2079,10 @@
+
+
+
+
@@ -2256,7 +2267,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/tag_installation.html b/tag_installation.html
index 4ed33d6..77994d4 100644
--- a/tag_installation.html
+++ b/tag_installation.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -2054,6 +2061,10 @@
+
+
+
+
@@ -2238,7 +2249,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/tag_model.html b/tag_model.html
index 1566b0f..2de6ddb 100644
--- a/tag_model.html
+++ b/tag_model.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -2102,6 +2109,10 @@
+
+
+
+
@@ -2286,7 +2297,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/tag_news.html b/tag_news.html
index 9fe2a96..4364f74 100644
--- a/tag_news.html
+++ b/tag_news.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -2036,6 +2043,10 @@
+
+
+
+
@@ -2220,7 +2231,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/tag_protocol.html b/tag_protocol.html
index 0431dd6..4fa8eb1 100644
--- a/tag_protocol.html
+++ b/tag_protocol.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -2192,6 +2199,10 @@
+
+
+
+
@@ -2376,7 +2387,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/tag_release_notes.html b/tag_release_notes.html
index bd4cbe5..1fa906c 100644
--- a/tag_release_notes.html
+++ b/tag_release_notes.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -2138,6 +2145,16 @@
+
+
+ <tr><td><a href="release_notes_112.html">Release notes 1.1.2</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Version 1.1.2 of Eclipse Ditto, released on 01.07.2020 </td>
+ </tr>
+
+
+
+
@@ -2322,7 +2339,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/tag_rql.html b/tag_rql.html
index 31250f2..7d46e66 100644
--- a/tag_rql.html
+++ b/tag_rql.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -2096,6 +2103,10 @@
+
+
+
+
@@ -2286,7 +2297,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/tag_search.html b/tag_search.html
index 8693b5b..d5f8b73 100644
--- a/tag_search.html
+++ b/tag_search.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -2072,6 +2079,10 @@
+
+
+
+
@@ -2256,7 +2267,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/tag_signal.html b/tag_signal.html
index 509a840..7670a1c 100644
--- a/tag_signal.html
+++ b/tag_signal.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -2071,6 +2078,10 @@
+
+
+
+
@@ -2255,7 +2266,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/tag_troubleshooting.html b/tag_troubleshooting.html
index ef846c8..69f1292 100644
--- a/tag_troubleshooting.html
+++ b/tag_troubleshooting.html
@@ -252,6 +252,13 @@
+ <li><a href="release_notes_112.html">1.1.2</a></li>
+
+
+
+
+
+
<li><a href="release_notes_111.html">1.1.1</a></li>
@@ -2042,6 +2049,10 @@
+
+
+
+
@@ -2226,7 +2237,7 @@
</div>
<p class="notice">
©2020 Eclipse Ditto.
- Site last generated: Jun 9, 2020 <br />
+ Site last generated: Jul 1, 2020 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
